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TECHNIQUES FOR PERMITTING ACCESS ACROSS A 
CONTEXT BARRIER IN A SMALL FOOTPRINT DEVICE 
USING GLOBAL DATA STRUCTURES 



CROSS-REFERENCES TO RELATED APPLICATIONS 
This application is related to U.S. Patent Application Serial Number 08/839,621 
filed April 15, 1997, entitled "VIRTUAL MACHINE WITH SECURELY 
DISTRIBUTED BYTE CODE VERIFICATION", in the name of inventors Moshe 
5 Levy and Judy Schwabe (Docket No. 50253-221/P3263), which application is 
incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Number 09/235,158 
filed January 22, 1999, entitled "TECHNIQUES FOR IMPLEMENTING SECURITY 
ON A SMALL FOOTPRINT DEVICE USING A CONTEXT BARRIER", in the name 
10 of inventors Joshua Susser, Mitchel B. Butler, and Andy Streich, (Docket No. 50253- 
216/P3708), which application is incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Number 09/235,1 57 
filed January 22, 1999, entitled "TECHNIQUES FOR PERMITTING ACCESS 
ACROSS A CONTEXT BARRIER ON A SMALL FOOTPRINT DEVICE USING 
15 AN ENTRY POINT OBJECT", in the name of inventors Joshua Susser, Mitchel B. 
Butler, and Andy Streich, (Docket No. 50253-2 17/P3709), which application is 
incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Number 09/235,155 
filed January 22, 1999, entitled 'TECHNIQUES FOR PERMITTING ACCESS 
20 ACROSS A CONTEXT BARRIER ON A SMALL FOOTPRINT DEVICE USING 
RUN TIME ENVIRONMENT PRIVILEGES", in the name of inventors Joshua Susser, 
Mitchel B. Butler, and Andy Streich, (Docket No. 50253-2 18/P37 10), which application 
is incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Number 09/235,159 
25 filed January 22, 1999, entiUed 'TECHNIQUES FOR PERMITTING ACCESS 
ACROSS A CONTEXT BARRIER IN A SMALL FOOTPRINT USING SHARED 
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OBJECT INTERFACES", in the name of inventors Joshua Susser, Mitchel B. Butler, 
and Andy Streich, (Docket No. 50253-220/P3712), which application is incorporated 
herein by reference in its entirety. 

BACKGROUND OF THE INVENTION 

5 Field of the Invention 

The invention relates to computer security and more particularly to techniques 
for implementing a security on small footprint devices, such as smart cards. 

Description of Related Art 

A number of object oriented programming languages are well known in the art. 

1 0 Examples of these include the C++ language and the Smalltalk language. 

Another such object oriented language is the JAVA™ language. This language 
is described in the book Java™ Language Specification , by James Gosling et al. and 
published by Addison-Wesley. This work is incorporated herein by reference in its 
entirety. The JAVA™ language is particularly well suited to run on a Java™ Virtual 

15 Machine. Such a machine is described in the book Java™ Virtual Machine 
Specification, by Tim Lindholm and Frank Yellin which is also published by Addison- 
Wesley and which is also incorporated herein by reference in its entirety. 

A number of small footprint devices are also well known in the art. These 
include smart cards, cellular telephones, and various other small or miniature devices. 

20 Smart cards are similar in size and shape to a credit card but contain, typically, 

data processing capabilities within the card (e.g. a processor or logic performing 
processing functions) and a set of contacts through which programs, data and other 
communications with the smart card may be achieved. Typically, the set of contacts 
includes a power source connection and a return as well as a clock input, a reset input 

25 and a data port through which data communications can be achieved. 

Information can be written to a smart card and retrieved from a smart card using 
a card acceptance device. A card acceptance device is typically a peripheral attached to 
a host computer and contains a card port, such as a slot, in to which a smart card can be 
inserted. Once inserted, contacts or brushes from a connector press against the surface 
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connection area on the smart card to provide power and to permit communications with 
the processor and memory typically found on a smart card. 

Smart cards and card acceptance devices (CADs) are the subject of extensive 
standardization efforts, e.g. ISO 7816. 
5 The use of firewalls to separate authorized from unauthorized users is well 

known in the network environment. For example, such a firewall is disclosed in U.S. 
Patent Application Serial No. 09/203,719, filed December 1, 1998 and entitled 
"AUTHENTICATED FIREWALL TUNNELLING FRAMEWORK" in the name of 
inventor David Brownell (Docket No. 50435-023/P2789/TJC), which application is 
1 0 incorporated herein by reference in its entirety. 

A subset of the full Java™ platform capabilities has been defined for small 
footprint devices, such as smart cards. This subset is called the Java Card™ platform. 
The uses of the Java Card™ platform are described in the following publications. 

JAVA CARD™ 2.0 - LANGUAGE SUBSET AND VIRTUAL MACHINE 
15 SPECIFICATION; 

JAVA CARD™ 2.1 APPLICATION PROGRAMMING INTERFACES; 
JAVA CARD™ 2.0 - PROGRAMMING CONCEPTS; 
JAVA CARD™ APPLET DEVELOPER'S GUIDE. 
These publications are incorporated herein by reference in their entirety. 
20 A working draft of ISO 7816 ~ Part 1 1 has been circulated for comment. That 

draft specifies standards for permitting separate execution contexts to operate on a smart 
card. A copy of that working draft is hereby incorporated by reference in its entirety. 

The notion of an execution context is well known in computer science. 
Generally speaking, the use of multiple execution contexts in a computing environment 
25 provides a way to separate or isolate different program modules or processes from one 
another, so that each can operate without undue interference from the others. 
Interactions -if any- between different contexts are deliberate rather man accidental, 
and are carefully controlled so as to preserve the integrity of each context. An example 
of multiple contexts is seen in larger hardware devices, such as mainframes, where a 
30 plurality of virtual machines may be defined, each such virtual machine having its own 
execution context. Another example is seen in U.S. Patent No. 5,802,519 in the name of 
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inventor De Jong, which describes the use of multiple execution contexts on a smart 
card. It will be appreciated by those of skill in the art that a computing environment 
which provides multiple execution contexts also needs to provide a mechanism for 
associating any given executing code with its corresponding context. 

5 Also well known is the notion of a current context. Certain computing 

environments that support multiple contexts will, at any given time, treat one context in 
particular as an active focus of computation. The context can be referred to as the 
"current context." When the current context changes, so that some other context 
becomes the current context, a "context switch" is said to occur. As will be appreciated 

10 by those of skill in the art, these computing environments provide mechanisms for 
keeping track of which context is the current one and for facilitating context switching. 

In the prior art, in the world of small footprint devices, and particularly in the 
world of smart cards, there was no inter-operation between contexts operating on the 
small footprint devices. Each context operated totally separately and could operate or 

1 5 malfunction within its context space without affecting other applications or processes in 
a different context. 

One layer of security protection utilized by the Java™ platform is commonly 
referred to as a sandbox model. Untrusted code is placed into a "sandbox" where it can 
"play" safely without doing any damage to the "real world" or full Java™ environment. 
20 In such an environment, Java™ applets don't communicate, but each has its own name 
space. 

Some smart card operating systems don't permit execution contexts to 
communicate directly, but do permit communications through an operating system, or 
through a server. 

25 The Problems 

A number of problems exist when trying to place computer programs and other 

information on a small footprint device. One of the compelling problems is the 

existence of very limited memory space. This requires often extraordinary efforts to 

provide needed functionality within the memory space. 
30 A second problem associated with small footprint devices is the fact that 

different small footprint device manufacturers can utilize different operating systems. 
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As a result, applications developed for one operating system are not necessarily portable 
to small footprint devices manufactured by a different manufacturer. 

If programs from more than one source of programs (manufacturer or vendor) 
are to be applied to a single small footprint device, security becomes a factor as one 
5 attempts to avoid corruption of existing programs and data when a new program is 
loaded on to the small footprint device. The same concern exists when one wishes to 
prevent a hacker or a malicious person from accessing programs and data. 

It is clear that small footprint devices such as smart cards don't have the 
resources necessary to implement separate virtual machines. Nevertheless, it is 
10 desirable to maintain strict security between separate execution contexts. 

In the past, security was provided by loading only applications from the same 
source or from a known trusted source onto a smart card or other small footprint device. 

Accordingly, it would be desirable to allow object-oriented interaction between 
selected execution contexts only in safe ways via fast efficient peer to peer 
15 communications which do not impose undue burdens on the programmer but facilitate 
dynamic loading of applets written at different times by un trusted sources. 

SUMMARY OF THE INVENTION 
The invention is directed to providing a context barrier (sometimes referred to as 
a firewall) for providing separation and isolation of one context from another and to 
20 provide controlled access across the barrier when that is needed. 

In accordance with the invention, two execution contexts, e.g. each containing 
one or more applets, running in the same logical (i.e., virtual or real) machine, protected 
from each other, can share information in a controlled, secure way, using language 
mechanisms, such as object-oriented language mechanisms. Security can be, for 
25 example, object by object. Thus, a method in a first execution context can access a first 
object A in a second execution context, but not a second object B in the second 
execution context on a selective basis. 

In accordance with one exemplary embodiment, an enhanced Java™ Virtual 
Machine (VM) provides certain run-time checks of attempted access across execution 
30 contexts in the VM. Checks can be automatic by the VM or coded by the programmer 
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with support from the VM. This can be done using language-level communication 
mechanisms. In this way, one can express object access across execution contexts in the 
same way as other object accesses using the language are made. These run-time checks 
provide a second dimension of defense/security beyond that which the Java™ language 
and platform already provide. 

These mechanisms provide protection against, e.g., security holes due to 
programming bugs (such as declaring a datum "public" (global) when it shouldn't be 
accessible to all contexts). They also allow fine-grain control of sharing (such as 
selection of objects to share and applets to share to). 

The invention is also directed to computer program products and carrier waves 
related to the other aspects of the invention. 

The foregoing and other features, aspects and advantages of the present 
invention will become more apparent from the following detailed description of the 
present invention when taken in conjunction with the accompanying drawings. 

BRIEF DESCRIPTION OF THE DRAWINGS 

The features and advantages of the present invention will be apparent from the 
following description in which: 

Figure 1 is an illustration of a computer equipped with a card acceptance device 
and of a smart card for use with the card acceptance device. 

Figure 2 is an illustration of a computer equipped with a card acceptance device 
connected to a network. 

Figure 3 is an exemplary hardware architecture of a small footprint device, such 
as a smart card, of the prior art. 

Figure 4 illustrates objects being accessed by principals as done in the prior art. 

Figure S is an exemplary security model which can be used in explaining the 
various embodiments of the invention. 

Figure 6 is a block diagram showing separation of execution contexts by a 
firewall or context barrier in accordance with one aspect of the invention. 

Figure 7 is a representation of a software architecture useful in carrying out the 
invention. 
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Figure 8 is a flow chart of a security enforcement process implementing a 
firewall in accordance with one aspect of the invention. 

Figure 9 is a block diagram showing object access across a firewall in 
accordance with one aspect of the invention. 

Figure 10 is a block diagram showing cascaded object access across a firewall. 

Figure 1 1 is a flow chart of a process for permitting access by a principal in one 
context across a firewall into another context 

Figure 12 is a block diagram illustrating the use of an entry point object to 
permit access across a firewall. 

Figure 13 is a block diagram illustrating the use of a global data structure such 
as an array for access across a firewall. 

Figure 14 is a block diagram illustrating the use of a supcrcontext to permit 
access across a firewall. 

Figure 15 is a block diagram illustrating the use of shareable interface objects to 
permit access across a firewall. 

Figure 16 is a flow chart of a security enforcement process permitting access 
across a firewall. 

Figure 17 is the flow chart of Figure 16 showing details of block 1620. 
Figure 18 is a flow chart showing an exemplary implementation of block 1629 
of Figure 17. 

NOTATIONS AND NOMENCLATURE 

The detailed descriptions which follow may be presented in terms of program 
procedures executed on a computer or network of computers. These procedural 
descriptions and representations are the means used by those skilled in the art to most 
effectively convey the substance of their work to others skilled in the art. 

A procedure is here, and generally, conceived to be a self-consistent sequence of 
steps leading to a desired result. These steps are those requiring physical manipulations 
of physical quantities. Usually, though not necessarily, these quantities take the form of 
electrical or magnetic signals capable of being stored, transferred, combined, compared, 
and otherwise manipulated. It proves convenient at times, principally for reasons of 
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common usage, to refer to these signals as bits, values, elements, symbols, characters, 
terms, numbers, or the like. It should be noted, however, that all of these and similar 
terms are to be associated with the appropriate physical quantities and are merely 
convenient labels applied to these quantities. 

Further, the manipulations performed are often referred to in terms, such as 
adding or comparing, which are commonly associated with mental operations performed 
by a human operator. No such capability of a human operator is necessary, or desirable 
in most cases, in any of the operations described herein which form part of the present 
invention; the operations are machine operations. Useful machines for performing the 
operation of the present invention include general purpose digital computers or other 
computational devices. 

The present invention also relates to apparatus for performing these operations. 
This apparatus may be specially constructed for the required purpose or it may comprise 
a general purpose computer as selectively activated or reconfigured by a computer 
program stored in the computer. The procedures presented herein are not inherently 
related to a particular computer or other apparatus. Various general purpose machines 
may be used with programs written in accordance with the teachings herein, or it may 
prove more convenient to construct more specialized apparatus to perform the required 
method steps. The required structure for a variety of these machines will appear from 
the description given. 

DETAILED DESCRIPTION 

Attached as an Appendix to this specification is an unpublished draft of a 
document entitled JAVA CARD RUNTIME ENVIRONMENT 2.1 SPECIFICATION. 
This draft document, which provides further detailed description of specific 
embodiments of the invention, is incorporated in its entirety as an integral part of the 
present specification. 

Although the inventive techniques are described hereinafter in the context of a 
smart card example, the example is merely illustrative and shouldn't limit the scope of 
the invention. 
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Figure 1 is an illustration of a computer 120 equipped with a card acceptance 
device 110 and a smart card 100 for use with the card acceptance device 110. In 
operation, the smart card 100 is inserted into card acceptance device 110 and power and 
data connections applied through a set of contacts 105 accessible at the surface of die 

5 smart card 100. When the card is inserted, mating contacts from the card acceptance 
device 110 interconnect with the surface contacts 105 to power-up the card and permit 
communications with the onboard processor and memory storage. 

Figure 2 is an illustration of a computer equipped with a card acceptance device, 
such as 120 in Figure 1 , connected to a network 200. Also connected to a network are a 
1 0 plurality of other computing devices, such as server 210. It is possible to load data and 
software onto a smart card over the network 200 using card equipped device 120. 
Downloads of this nature can include applets or other programs to be loaded onto a 
smart card as well as digital cash and other information used in accordance with a 
variety of electronic commerce and other applications. The instructions and data used to 

1 5 control processing elements of the card acceptance device and of the smart card may be 
stored in volatile or non-volatile memory or may be received directly over a 
communications link, e.g., as a carrier wave containing the instructions and/or data 
Further, for example, the network can be a LAN or a WAN such as the Internet or other 
network. 

20 Figure 3 is an exemplary hardware architecture of a small footprint device, such 

as a smart card, of the prior art As shown in Figure 3, a processor 300 interconnects 
with primary storage 310 which may include read only memory 315 and/or random 
access memory 316. The processor also connects with a secondary storage 320 such as 
EEPROM and with an input/output 330, such as a serial port. One can see the small 

2 5 footprint devices of this nature can be very simple. 

Figure 4 illustrates objects being accessed by principals as done in the prior art. 
As shown in Figure 4, physical device 400, such as the small footprint device may have 
contained within it one or more processing machines (virtual or physical) which are 
running an execution context 420. The execution context may be, for example, a 

30 context associated with a particular applet One or more principals 430 (e.g., applets or 
applications) in the execution context may seek to access other objects within the 
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execution context. As long as the access occurs within the execution context, the 
accesses will be permitted and everything will function normally. 

Figure S is an exemplary security model which can be used in explaining the 
various embodiments of the invention. It is just one of many models which might be 

5 utilized but is a convenient model for this purpose. In this model, a principal 
(sometimes called entity) 500 proposes to take an action 510 on an object, such as object 
520. Security checks may be imposed on the principal, on the object, and/or on the 
action proposed to be taken. 

In Figure 5, two types of objects are shown on which action may be taken by a 

10 principal. These include data objects, (e.g. datal and data2 (520, 520')) and entity 530. 
A principal may operate or attempt to operate on any of these objects. 

While data is passive, an entity 530 is active. The diagram line from Principal to 
an active entity is also labeled "action," but this could be a more sophisticated and 
arbitrarily complex action, such as making a function or method call or sending a 

IS message as compared with action on a data object. As with data, a security check 
enforced by the operating system may use the identity of the principal, the identity ofthe 
entity, and/or the type of action. Furthermore, the entity, being active, can perform its 
own additional security checks. These can be as arbitrarily complex as one desires, and 
can make use ofthe identity ofthe Principal, the identity ofthe entity itself, the action, 

20 and/or any other information that is available. 

In an object-oriented system (such as the Java Card™ platform) "objects" are 
typically a combination of data and entity. When a Principal tries to access a field of an 
object, this is a data access-a fairly simple action protected by a fairly simple security 
check. When a Principal tries to access a method of an object, this is an entity access, 

25 which can be arbitrarily complex both in action and in security check. 

Figure 6 is a block diagram showing separation of execution contexts by a 
firewall or context barrier in accordance with one aspect of the invention. The physical 
device 400 and the machine 410 correspond to the same items shown in Figure 4. An 
execution context 420 shows one principal 430 attempting to access object 440 within 

30 the context. This access would normally succeed. However, execution context 420 also 
shows a principal 630 attempting to access object 640 of execution context 620, across a 
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context barrier 600, Normally, this access would be prohibited as indicated by the X 
636 where the action 635 crosses the context barrier 600. 

Figure 7 is a representation of a software architecture useful in carrying out the 
invention. This software architecture is shown as a run time environment 700. An 
5 operating system 710 for the small footprint device is commonly used. A virtual 
machine 720, in an exemplary embodiment of the invention, is implemented over the 
operating system. The virtual machine could be a Java Card™ virtual machine or other 
virtual machine. The capabilities of a standard virtual machine can be expanded to 
provide the additional functionality described herein or the functionality can be provided 

10 as separate modules. The virtual machine 720 may include an interpreter or native 
implementation 730 which provides access to a run time system 740. The run time 
system includes object system 750 for managing the objects of an object oriented 
implementation. Three contexts, 760, 770 and 780, are shown. Each context is 
separated from the other by a context barrier (sometimes referred to as a firewall) 

15 between the execution contexts. Context 760 is, in one specific embodiment, a 
supercontext. That is, context 760 has privileges and capabilities not available to 
subordinate contexts 770 and 780, potentially including privileges to create entry point 
objects or global data structures, and to access objects in subordinate contexts 770 and 
780. 

20 Every object is associated with one particular context. That context is said to 

own each object that is associated with it. The runtime system 740 provides a means for 
uniquely identifying contexts, and a means for specifying and identifying the currently 
executing context. The object system 750 provides a mechanism for associating objects 
with their owning contexts. 

25 For example, the runtime 740 can identify contexts with a unique name, and 

correspondingly the object system 750 can associate objects with that context by 
recording the context's name in the object's header. Information in the object's header 
cannot be accessed by programs written in the object-oriented language, but is only 
available to the virtual machine 720 itself. Alternately, the runtime system 740 can 

30 identify contexts by dividing the memory space into separate regions, each for a 
particular context, and correspondingly the object system 750 can associate objects with 
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that context by allocating the object's storage in that context's memory space. 

Figure 8 is a flow chart of a security enforcement process implementing a 
context barrier in accordance with one aspect of the invention. When a principal 
invokes an action on an object (800) a check is made to determine whether the object is 
5 within the context of the principal (810). If it is not, the action is disallowed (840). 
Otherwise, the action is permitted (830). This is the simplest form of context barrier or 
firewall. In one specific embodiment the action is disallowed (840) by throwing a 
security exception if the object is outside of the namespace or the memory space of the 
context requesting access. 
10 Figure 9 is a block diagram showing object access across a firewall in 

accordance with one aspect of the invention. Figure 9 is substantially similar to Figure 
6. However, Figure 9 also shows principal 900 seeking to access object 910 in order to 
perform action 905 on the object 910. According to the invention, rather than having 
the access blocked by the firewall 600, in the way that action 635 is blocked, action 905 
15 is permitted to occur across the firewall through access point 920 so that principal 900 
can perform action 905 on object 910 notwithstanding the fact that the principal and the 
object are in different execution contexts. The mechanisms behind access point 920 are 
described below with reference to Figures 12-18. Note that access point 920 can 
coexist with obstructed accesses such as X 636. Thus access point 920 provides fine- 
20 grain control of sharing (object by object security) across context barrier 600. 

When object access 900 is initiated, the current context setting is context 420. If 
the object 910 is a data object, the action 905 is a simple data access, and no code is 
executed in the second context 620. If the object 910 is an entity object, and the action 
905 results in that object's code being executed, that code is executed in the second 
25 context 620. To execute the code of object 910 in the correct context 620, the virtual 
machine 410 performs a context switch. The context switch changes the current context 
setting to be context 620, and the previous value of the current context setting is stored 
so that it can be restored later. From that point on code will execute in the new current 
context. When the action 905 completes, control is returned to the point following 
30 access 900. During the return, the virtual machine 410 must restore the value of the 
current context setting to its previous value. 
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Figure 10 is a block diagram showing cascaded object accesses across a 
firewall. Figure 10 shows three execution contexts, 1000, 1010 and 1020. Principal 
1030 in execution context 1 seeks to invoke an action 1035 on object 1050 in execution 
context 2 and does so through access point 1070 in context barrier 600. Object 1050 in 
execution context 2 has an object access 1040 which seeks to perform an action 1045 on 
the object 1060 in execution context 3. It achieves this by using access point 1080 in 
context barrier 600' separating execution contexts 2 and 3. Object 1050 in execution 
context 2 also has another object access 1090 which invokes an action 1095 on an object 
1099 in the same execution context, that is, in execution context 2. Both actions 1035 
and 1045 result in context switches as described in the explanation of Figure 9. But as 
action 1095 does not cross the context barrier, a context switch is not required for its 
execution, and therefore does not occur. 

Figure 11 is a flow chart of a process for permitting access by a principal in one 
context across a firewall into another context. There are essentially three steps to this 
process. In execution context 2, an object to be accessed is created and designated as 
shared (1100). In execution context I, the principal obtains a reference to the object in 
execution context 2 (1110). The principal in execution context 1 then invokes an action 
upon the object designated as shared in context 2 (1120). 

With respect to identifying or designating a created object as shareable as 
discussed in item 1100 of Figure 11, this can be done, in accordance with a specific 
embodiment of the invention, by including a shareable attribute in the header of an 
object's representation. Information in an object's header cannot be accessed by 
programs written in the object-oriented language, but is only available to the VM itself. 

Obtaining a reference to an object in another context is a special case of 
accessing an object in another context. A mechanism that provides access to an object 
in another context can make other objects available also. For instance, invoking a 
method on an object in another context may return a reference to a second object in a 
different context. An additional mechanism is required to allow an initial reference to 
an object in a different context to be obtained. In a specific embodiment, references to 
certain well-known entry point objects can be obtained using a public API. Once the 
initial reference to an object in a different context is obtained, further references can be 



WO 00/45262 



14 



PCT/US00/01234 



obtained from thai object, and so on. 

There are four general approaches to obtaining information across a context 
barrier in accordance with the invention. These approaches can be utilised individually 
or in combination in order to access an object across a context barrier or to obtain a 
reference of an object to be accessed across a context barrier (1110). These approaches 
are described in Figures 12-18. 

Figure 12 is a block diagram illustrating the use of entry point objects to permit 
access across a context barrier. As shown in Figure 12, some object 1200 in context 
770 (context 1) desires access to information in supercontext 760. In the specific 
embodiment, a supercontext 760 contains at least one entry point object 1210. The 
entry point object 1210 can be published as part of a public API, or can be made 
available indirectly through a published API (e.g., in accordance with the mechanisms 
described previously with reference to Figure 11), so that each context subordinate to 
the supercontext may communicate with the entry point object of the supercontext. (It 
will be appreciated that in other embodiments, entry point objects may be housed by a 
context other than the supercontext.) 

Figure 13 is a block diagram illustrating the use of global data structures to 
permit access across a firewall. In this approach, supercontext 760 creates a global data 
structure such as a global array. In the specific embodiment supercontext 760 is the 
only context permitted to create such a global data structure. (It will be appreciated that 
in other embodiments, global data may be housed by a context other than the 
supercontext.) By virtue of its global status, each of the contexts 770 and 780 may read 
and write to the global data structure. Thus, information written into the global data 
structure by one context can be read by another context. For example, this mechanism 
can be used to pass binary data or references to objects between contexts. 

Figure 14 is a block diagram illustrating the use of supercontext privileges to 
permit access across a context barrier. In Figure 14, an object in supercontext 760 seeks 
access to context 780 across the context barrier separating the two. Supercontext 760 
can invoke any of the methods of context 780 and can access any of the data contained 
within context 780, by virtue of the privileges associated with the supercontext. 
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Figure 15 is a block diagram illustrating the use of shareable interface objects to 
permit access across a firewall. A shareable interface defines a set of shareable interfece 
methods. A shareable interface object is an object that implements at least the set of 
methods defined in a shareable interface. In Figure IS, object 1210 in context 2 (780) 
is a shareable interface object. An object access 1200 in another context 770 can invoke 
any of the shareable interface methods on the object 1210 if the principal of the object 
access 1200 is authorized to do so by the object 1210 itself. This authorization is further 
discussed with reference to Figure 18 below. 

It will be appreciated that a virtual machine consistent with the invention 
provides functionality beyond that of earlier virtual machines, such as the virtual 
machine described in the Java™ Virtual Machine Specification. In particular, 
consistently with the invention, the virtual machine provides functionality to implement 
or to facilitate a security enforcement process that permits access across a firewall. This 
process is described next with reference to Figures 16-18. Note that it is applicable to 
any approach for providing access across the firewall, including but not limited to the 
four approaches described with reference to Figures 12-15 above. 

Figure 16 is a flow chart of a security enforcement process permitting access 
across a firewall. When a principal attempts to invoke action on an object 1600, a check 
is made to determine if the object is within the context of the principal (1610). If it is, 
(1610-Y), the action is permitted (1630). If it is not, (1610-N), a check is made to see if 
the action by the principal is permitted on the object (1620). If it is, (1620-Y), the action 
is permitted (1630). If it is not, (1620-N), the action is disallowed. In the specific 
embodiment a security exception is thrown (1640). 

Figure 17 is the flow chart of Figure 16 showing further details of block 1620. 
If the object is not within the context of the principal (1610-N), a plurality of tests, 1621, 
1622, 1623... 1629 are undertaken to see if the action by the principal is permitted on the 
object. These tests can be done by the virtual machine alone or by the virtual machine 
plus the object, in a virtual machine object oriented implementation. If any of the tests 
results in a pass, the action is permitted (1630). However, if all tests result in a negative 
determination (162X-No), the action will be disallowed. In a specific embodiment, a 
security exception will be thrown (1640). These tests relate to the permitted access 
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discussed in conjunction with Figures 12-1S. 

Figure 18 is a flow chart showing an exemplary implementation of block 1629 
of Figure 17 for use with access method described in Figure 15. In a test, such as 829 
or 1629, a virtual machine checks if the object is a shared object 1810. If it is not (1810- 
5 No), the test will fail. However, if it is (1810- Yes), the virtual machine will invoke the 
method A on object O (1820). If the method A on object O determines that the principal 
is authorized (1830), the test will be passed (1840) and access permitted. Otherwise, the 
test will fail (1850). This allows the authorization text to be programmed into the code 
of the object itself. 

10 Although the invention has been illustrated with respect to a smart card 

implementation, the invention applies to other devices with a small footprint, not just to 
smart cards. Devices with a small footprint are generally considered to be those that are 
restricted or limited in memory or in computing power or speed. Such small footprint 
devices may include boundary scan devices, field programmable devices, pagers and 

1 5 cellular phones among many others. 

In general, small footprint devices are resource constrained computational 
devices and systems where secure interoperation of execution contexts is a concern. 
Such small devices impose constraints on the implementation of security measures 
because of their limited resources. Because of resource constraints, in a virtual machine 

20 implementation, a single virtual or physical machine must be used as opposed to 
multiple virtual machines. 

The invention may also be applied to devices with larger footprints where the 
characteristics of the invention may prove beneficial. For example, the invention may 
prove advantageous when using servlets if there is object sharing between them. Even 

25 some desktop systems may profitably utilize the techniques of the invention. 

While the Java™ language and platform are suitable for the invention, any 
language or platform having certain characteristics would be well suited for 
implementing the invention. These characteristics include type safety, pointer safety, 
object-oriented, dynamically linked, and virtual-machine based. Not all of these 

30 characteristics need to be present in a particular implementation. In some embodiments, 
languages or platforms lacking one or more of these characteristics may be utilized. A 
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"virtual machine" could be implemented either in bits (virtual machine) or in silicon 
(real/physical machines). 

Although the invention has been illustrated showing object by object security, 
other approaches, such as class by class security could be utilized. 
5 Although the present invention has been described and illustrated in detail, it is 

clearly understood that the same is by way of illustration and example only and is not to 
be taken by way of limitation, the spirit and scope of the present invention being limited 
only by the terms of the appended claims and their equivalents. 
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Preface 



Java™ Card™ technology combines a portion of the Java programming language with a runtime environment 
optimized for vasal cards aad related, small-memory embedded device*. Hie goal of lava Otrd technology it to 
bring many of the benefit! of Java software programming to tise resmtrca-conetraiiuad world of smart card*. 

Thia document la a specification of the Java Card Runtime Environment (JCRE) 2,1. A vendor of a Java Card- 
enabled device provides an Implementation of the JCRE, A JCEE implementation within the context of thia 
spedjieatidn refers to a vendor'* implementation of the Java Canj Virtual Machine (VM), the Java Card 
Application Programming Interface (API), or other component, based on the Java Card technology 
specifications, A Refennet Implementation is an implcmerUaOan produced by Sun Microsystems, Inc. Applets 
written for the Java Card platform are referred to as Java Card applets. 



Who Should Use This Specification? 

This specification it intended to assist JCRE imp) em enters in creating an implementation, developing a 
specification to extend the Java Card technology specifications, or in creating an extension to the Java Card 
Runtime Environment (JCRE). This specification is also intended for Java Card applet developers who want a 
greater undemanding of the Java Card technology specifications. 



Before You Read This Specification 

Before reading mis guide, you should be familiar with the Java programming language, the Java Card 
technology specifications, and smart card technology. A good resource for becoming familiar with Java 
technology and Java Card technology is the Sun Microsystems, be website, located at 



How This Specification Is Organized 

Chapter i, "The Scene and Respe&tSbtfMet of the JCRE," gives an overview of the services required of a 
JCRE implementation. 

Chapter X, "lifetime of the Virtual Machine," defines the lifetime of the Virtual Machine, 
vi CopyrioM© December 14, 1998 Sun Microsystems, Inc. 
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Chapter 3, "Applet Lifetime," define* the lifetime of an applet 

Ctapto- 4, "Trwient Object*," provides an overview of transient objects. 

Chapter 5, "Selection," describes how the JCRE handles applet selection. 

Chapter 6, -Applet Isolation and Object Sberieg," describe* tppln isolatiat tad <*je« shmitig. 

Chapter 7, "Transactlotu and Atomicity," provide* an overview of atomicity during trapracticms. 

Chapter 8, "API Topics," describes API functionality required of a JCRE but not completely specified in the 
Java Card 2.1 API Specification. 

Chapter f , " Virtual Machine Topics," describes virtual machine specifics. 
Chapter 10, "Applet Installer," provides an overview of the Applet Installer. 

Chapter 11, "API Constants," provides the numeric value of constants that are not specified in the Java Card 
API 2.1 Specification. 

Glossary is a list of words sad their definitions to assiit you in using this took. 



ftefewaoo is various documents cm products are SMde in this manual. You sriouid h*ve the following 
da-.w«,-ats available: 

■ Java Card 2. 1 API Draft 2 Specification. Sun Miaosyttema, lac. 

■- Java Card 2.0 Language Sublet and Virtual Machine SpedfUxttion, October!}, 1997, Revision 1.0 Fatal, 
Sua Microsystems, Inc. 

■ Java Card Applet Developer 't Guide. Sun Microsystems, Inc. 

■ The Java Language Specification by James Gosling, Bill Joy, and Guy !_ Steele. Addison-Wesley. 1 996, 
ISBN 0.201-63451-1. 

HI The Java Virtual Machine Spedfkatian (Java Series) by Tim Undhatm and Frank Yell in. Addison- 

Wesley, 1996. ISBN 0-20 1 -63452-X. 
m ru Java Class libraries: An Annotated Reference (/am Series) by Patrick Chan and Rosaana Lee 

Addisoo-Wesley, rwo volume*. ISBN: 0201310023 sad 0201310031. 

■ ISO 7816 Specification Parts !•& 

■ EMV '96 Integrated Circuit Card Spedfication for Payment Systems. 




Related Documents and Publications 
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1 . Introduction 



The Jaw Card Runtime Environment (JCRE) 2. 1 contain* the Java Card Virtual Machine (VM). die Java Card 
Application Programming Inter&ee (API) dasses (and industry- specific extension i), and support services. 

This document, the JCRE 2. 1 Specification, specifies the JCRE fiaictionality required by the Java Card 
technology. Any implementation of Java Card technology shall provide this necessary behavior and 
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2. Lifetime of the Java Card Virtual Machine 



In » PC w werteation, the Java Virtual Machine nnuin operating system process. When the OS process ii 
tenmnatcd, the J«va ippltcaoons and their objects are automatically destroyed. 

In Jav* Card technology the execution lifetime of the Virtual Machine (VM) is the lifetime of the card. Most of 
the m formation stored on a card shall be preserved even when power is removed from the cm± Pertistent 
memory technology (such as EEPROM) enable, a smarted to ,,fo !I „,K-a *en.po» uZm 
Since the VM and the objects created w me card are used to represent application tafamatioo fen b pasiaent. 
the Java Card ™ appear* to run forever. When power is removed, the VM Hops only teitsporerily. When the 
card is next reset, die VM nam up again and r ecovera its previous object heap from persistent storage. 

Aside from its omittem nature, the Java Card Virtual Machine u just like the Java Virtual Machine, 
the card Wtialuadon time ii the time afler raaaking, and prior to (he time of card pertonaJteatkm and Issuance. 
^^ZiT^T^T^ ^n™* U l nitiahTOl ' faraewk ™l by the JCRE exist for 
rhe hfeume of the V.nua! Michme. ftecouu die execution lifetime of the Virtual Machine and the JCRE 
framework span CAD session* of the card, the lifetimes of objects created by applets will also span CAD 
sessions. (CAD means Card Acceptance Device, or card reader. Card stations are those period* when the card 
is inserted in the CAD, powered up, and exchanging streams of APDUi with the CAD. The card session cods 
when me card is removed from the CAD.) Objects that have this property are called persistent objects. 
The JCRE iraplemcntn r.Ji snake an otjoc; .-. ai^at when: 

" *£Sl et ■ r °3 iBter n*"** « called. The JCRE stores a reference to the instance of the applet object 
The JCRE rmpletnenter shall ensure that cutanea of das* applet are persistent 

• A reference lo an object is stared m a field of any other pemttent object or in a class** static field. This 
requirement stems from the need to preserve the integrity of the JCRE'* internal data structures. 



C-awrtara©OacOTr^14,t998 ^ 2-1 



SUBSTITUTE SHEET (RULE 28) 



WO 00/45262 



PCTAJSOO/01234 



3 . Java Card Applet Lifetime 



For the purposes of this tpccincation, a Java Card applet '* lifetime begins at the point thai it ha* bees comedy 
leaded into card memory, linked, and otherwise prepared for execution. (For the remainder of this specification, 
applet refers to an applet written for the Java Card platform.) Applets registered with the Applet, ragioter 
method exist for the lifetime of the cant The JCRE interacts with the applet via the applet'* public methods 
install, select, deselect, and procoaa . An applet shall implement the static install method. If the 
install method is not implemented, the applet's objects cannot be created or initialized. A JCRE 
implementation shall call an applet's install, select, deselect, and process methods as described 



e by the JCRE for each 



3.1 The Method install 

When install is called, no objects of the applet exist The main task of the install method within the applet 
is to create an instance of the Applet class, and to register the instance. Alt other objects that the applet will 
need during its lifetime ran be created as is feasible. Any other preparations necessary for the applet to be 
selected and accessed by a CAD alto can be done as is feasible. The install method obtains initialization 
parameter* from the coo tents of the meaning byte array parameter. 

Typically, an applet create* various objects, tnreatixes them with predefined value*, sets tome internal state 
variables, and calls the Applet . register method to specify the AID (applet Ocntificr as defined m ISO 
78 1 4-5) to be used to *elect h. Tot* installation Is considered succesarutwnen me rail to the 
Applet .register method completes without an exception. The installation is deemed unsuccessful if the 
install method doe* not call the Applet . regrf sear method, or if an exception i* thrown from within the 
in* tat i method prior to the Applet . register method being called, cr if the Applet . regi ster method 
throw* aa exception. If the msttllafl'oo is unsuccessful, the JCRE shall perform all cleanup when it regains 
control, That is, all persistent objects shall be returned to the state they had prior to calling the install 
method. If the installation is successful, the JCRE can mark the applet a* available for selection. 



ar 14. 1998 Sun Mtaosysterns. Inc. 3-1 



SUBSTITUTE SHEET (RULE 2S) 



PCT/USO0/O1234 
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3.2 The Method select 

Applet! remain in a suspended su 
a SELECT APDU in which the n 
the currently selected applet 



Prior to calling SELECT, the JCRE shall deselect the previously selected applet The JCRE indicates this to the 

applet by invoking the applet's deselect method. 

The JCRE informs the applet of selection by invoking its eeleet method. 

The applet may decline to be selected by returning false from the call to the aalect method or by throwing 
an exception. If the applet returns true, the actual SELECT APDU command is supplied to the applet in the 
subsequent call to its process method, so that the applet can examine the APDU contents. The applet can 
process the SELECT APDU command exactly (ike it processes any other APDU c omman d. It can respond to 
the SELECT APDU with data (see the process method for details), or ft can flag.erron by throwing an 
1 soEwjepeion with the appropriate SW (returned status word). The SW and optional response data are 
returned to the CAD. 

The Applet . select lngftpples method shall return true when called daring the •elect method. The 
Applet . eelectingApplet method will continue to return true during the subsequent process method, 
which U called to process the SELECT APDU command. 

If the applet declines to be selected, the JCRE will return an APDU response status word of 

1 so . SW_AS>PLET_SEUKCT_FA1LED to the CAD. Upon selection Mure, the JCRE state is set to Indicate that 

no applet is selected. 

After successful selection, all subsequent APDUs are delivered to the currently selected applet via the process 
method. 



3.3 The Method process 



All APDUs are received by the JCRE, which passes an instance of the APDU das* to the process method of 
the currently selected applet. 

Note *- A SELECT APDU might cause a change in the currently selected applet prior to the call to the 
process method. 

On normal return, the JCRE aittarratkally appends 0x9000 as the completion response SW to any data already 
sent by the applet 
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3.4 The Method deselect 

■ ■ When she JCRE receive* a SE1ECT AJPDU amamd in which fee name matches the AID of an applet, the 
JCRE cssliis Shi DESELECT method of the etamitiy selected applet litis allows the appld to perform my 
cleanup operation* that may be respired in wder to silew some other applet to execute. 

The Applet . eelectingApploc method shall return false when called during the deselect method. 
Exception* thrown by the deselect method are caught by the JCRE, but the applet is deselected. 



3.5 Power Loss and Reset 

Power loss occurs when the card is withdrawn from the CAD or if there is some other mechanical or electrical 
failure. When power is reapplied to the card and on Card Reset (warm or cold) the JCRE shall ensure that 

• Transient data is react to the default value 

• The transaction in progress. If uny, when power was lost (or reset occurred) is aborted, 

• The applet that was selected when power was lost (or reset occurred) become* implicitly deselected. (In 
thia ease the deselect method is not called.) 

« If the JCRE implements default applet selection (see paragraph S. IX the detauit applet Is selected as the 
currently selected applet, and that the default applet's oelecc method is called. Otherwise, the JCRE sets 
it* state to indicate that no applet is selected. 
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4. Transient Objects 



Applets soraetimu require objects thu contain temporary (transient) data thai need net be persistent across 
CAD sessions. Java Card does not support the Java keyword tranainnt. However, Java Card technology 
provides methods to create transient arrays with primitive components or references to object . 

The torn "transient object" U a misnomer, it can be incorrectly interpreted to mean mat me object itself is 
transient However, oniy the cnnienu of she Belds of the object (except for the length field) have a transient 
nature. As with any other object in the hit programming language, traimenl objects within the Java Card 
pisiform exist as long as they are referenced from: 



• A field in another existing object 

A transient object within the Java Card platform has the following required behavior 



an*, the fields of a transient object shall never be stored in a "persistent memory 
og current smart card technology as an example, the contents of transient objects can be 
sttrred in RAM. but never in EEPROM. The purpose of this requirement ii to allow transient objects to be 
usssd to More session keys. 

Writes to the fields of a transient object shall not have a performance penalty. (Using current smart card 
technology as an example, the contents of transient objects can be stared in RAM, while the contents of 
noo-transient objects can be stored in EEPROM. Typically, RAM technology has a much faster write cycle 
time than EEPROM.) 

Write* » the fields of ■ transient object shall not be affected by "mnne&x*.* That is, aa 
abortTrtiasactlcai will never causer ho . nr. tra ion object to b — r V •. •• p rviouj value. 
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4. 1 Events That Clear Transient Objects 

ts are used for maintaining states that dull be preserved acr 

S, one of (wo event* are specified that cause its fidd* to be dewed. CLEAR_ON_RESET 



Details of the two dor events ire as follows: 

• CLEAR_.ON_RESET— the object's fields are cleared when the card is reset, When a card is powered or 



et necessary to dear the fields of transient objects before power is removed from a card. 



• CLEAR w ON_DESEL£CT~-the object's fields are cleared whenever any applet is deselected. Because a 
sard reset implicitly deselects the currently selected applet, die fidds of CLEAR_ON_DES ELECT objects 
are also cleared by the same events specified for CLEAR_ON_RESET. 

The currently selected applet is otpltony deselected (its deselect method is called) only when a SELECT 
command Is processed. The currently selected applet is deselected and then the fidds of all 
CLEAR_ONJDES ELECT transient objects are cleared regardless of whether the SELECT command: 



Feits to select an applet 
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5. Selection 



Cards receive requests for service from the CAD In the farm of APDUs. The SELECT APDU is used by the 
JCRE to designate » currtmly itleeled applet. Once selected, an applet receives all subsequent APDUs until the 
applet becomes deselected 

There is no currently selected applet when either of the following occurs: 

e The card Is reset and no applet r»as pre-designated as ihe d^imli appt^i. 



5.1 The Default Applet 



After card reset (or power on, which is a form of reset) the JCRE performs its initialtationi and checks 
to see if its internal state indicates that a particular applet it the default applet. If so, the JCRE makes this 
applet the currently selected applet, and the applet's select method Is called. If the applet's select 
method throws an exception or returns false, then the JCRE sets its state to indicate that no applet is 
selected. (The applet's process method is not called during de&ult applet selection because there is no 
SELECT APDU.) When a default applet is selected at card reset, it shall not require its process 
method to be called 

. The JCRE ensures that die ATR has been asm aad the card in now ready to icoept APDU commands. 



The mechanism for specifying a default applet is not defined in the Java Card API 2. 1 . It is a JCRE 
implementation detail and ia left to the individual JCRE implementers. 
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5.2 SELECT Command Processing 



The SELECT APDU commsad it msd to select as applet Its behavior is: 

I. Hie SELECT APDU is always procesatd by the JCRE t cg&rdless of which, IS any. applet is active. 



a) ApplttSI 

b) Apples SELECT oammsad u*es "Selection by DF aatae". Therefore, P i -OxW. 

c) Any other value of PI implies that is not an applet select. The APDU is processed by the as 



d) JCRE shall support exact DF name (AID) selection te P2-%bO000 wcOO. (M.b3» are donl care). 

e) All other partial DF name SELECT options (b2,b I •) arc JCRE implementation dependent. 

f) All file eonool mformasjon option cades (M.b.3 9 ) liuli be mppmteti by she JCRE and tnterpretad 
and processed by the applet. 

3. If no AID match ia found: 



b. Otherwise, the SELECT cammmd Is forwarded te the cwrwUy selected applet's process method, 
A context switch into the applet's tooted casus at this poist. (The applet contort is defined in 
paragraph 6.1.1.) Applets may use the SELECT APDU csEonund fbr their own manse! SELECT 

4. lis matching AID is found, the JCRE prepares to select the new applet If there is an currently selected 
apptet. it is deselected via a call to its de-select saahod. A contest switch into the deselected applet's 
context occurs at this point The JCRE context is restored upon east from doeeleee. 

5. The JCRE sets the new currently selected applet The new applet is selected via a call to its select 



a. If fee applet's aslact method throws aa ewwpacss or returns false, then JCRE stale is set so that no 
apptet is selected. The JCRE responds to the SELECT comuwr. with ra&w code Ox&W 
(SW_APPLETJSELECT„FA1LED). 
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IfthematAmg AID is the ttme as the currently .elected applet, the JCRE stilt goes through the process of 
teeing the applet and then selecting it. Selection could fitil. leaving the card in a w&tppte , 



5.3 Non-SELECT Command Processing 

When a non-SELECT APDU is received and there is no currently selected applet, the JCR£ shall resomd to the 
APDU wtth status code 0x6999 (SW^WPLET_S£LECr_FAILED). 

When a rK»-SELECT APDU is received and there is a currently selected applet, the JCRE invokes the 
process method of the currently selected applet passing the APDU as a parameter. This causes a context 
switch from the JCRE context into the currently selected applet's context. When the process method exits. 

JCRE context. The JCRE sends a response APDU and waits for the ne 



Copyright © Dseambar 14. 1 898 Sun Microsystems. Inc. 5-3 



suBsnrrruTE sheet (rule as) 



WO 00/45262 



PCTAJ80G/01234 



35 

Java™ Card ™ Runtime Environment (JCRE) 2, ! Specification 



6 . Applet Isolation and Obj ect Sharing 



Any implementation of the JCRE dull support isolation of contexts and applets. Isolation mean* that one applet 
tan not access the field* or object! of an applet in another context unless the other applet explicitly provides an 
interface for access. The JCRE mechanisms for applet Uolation and object sharing are detailed in the sections 
below. 



6.1 Applet Firewall 

The applet firewall within Java Card technology is runtiroe-en forced protection and is separate from the Java 
technology protections. The Java language protections still apply to Java Card applets. The Java language 
ensures that strong typing and protection attributes are enforced. 

Applet firewalls are always enforced in the Java Card VM They allow the VM to automatically perform 
additional security checks at rantime. 



6.1.1 Contexts and Context Switching 

Firewalls essentially partition the Java Card platform's object system into separate protected object spaces 
called contexts. The firewall is the boundary between one context and another. The JCRE shall allocate and 
manage an applet contort fa each applet that is installed on the card. (But see paragraph 6.1.1.2 below for « 
discussion of group contexts.) 

In addition, the JCRE maintains it» own JCRE context. This context is much like an applet context, but H has 
special system privileges so that it can perform operations that are denied to applet contexts. 

At any point ia time, there is only one active context within the VM. (This is called the currently active 
context.) All bytecodes that access objects are checked at runtime against the currently active context in order to 
deteniune if the access is allowed. A java . Xang. Security Except ion is thrown when an access is 
disallowed. 

When certain well-defined conditions are met during the execution of invoke-typc bytecodes as described m 
paragraph 6.2.8, the VM performs a context nvltch. The previous context ii pushed on an interna) VM stack, a 
new context becomes die currently active context, and the invoked method execute* in this new context Upon 
exit from that method the VM performs a restoring context twitch. The original context (of the caller of the 
method) si popped «rom the Back and is restored as the currently active context. Context switches can be 
nested. The maximum depth depends on the amount of VM rack space available. 
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Most method invocations in Java Card technology do not cause a context switch. Contest switches only occur 
during invocation of and return from certain methods, as well is during exception exits from those methods (set 



During a context-switching method invocation, in additional pace of data, indicating the currently active 
context, is pushed onto dw return stack. This context is restored when the method is exited. 

Further details of contexts and context switching are provided in later sections of this chapter. 
6.1.1.1 Group Contexts 

Usually, each instance of a Java Card applet defines a separate context. But with Java Card 2. I technology, the 
concept of group context is introduced. If more to one applet is contained in a single Java package, they share 
the same context Additionally, all instances of the same applet dan share the same context In other words, 
there is no firewall between two applet instances in a group context. 

The discussion of contexts and context switching above in section 6. 1. 1 assumes that each apples instance is 
associated with a separate context In Java Card 2.1 technology, contexts are compared to enforce the firewall, 
and the instance AID Is pushed onto the stack. Additionally, this happens not only when the context switches, 
but also when control switches from m object owned by one applet instance to an object owned by another 
snsttnee within the same package. 



6. 1 .2 Object Ownership 

When a new object is created, it is associated with the currentiy active context. But the object is owned by the 
applet instance within the currently active context when the object is instantiated. An object is owned by an 
applet instance, or by the JCRE. 



6.1.3 Object Access 

In general, an object can only be accessed by its owning context, that is, when the owning context is the 
currently active context The firewall prevents an object from being accessed by another applet in a different 

In implementation terms, each time an object is accessed, the object's owner context is compared to the 
currently active context. If these do not match, the access is not performed and a Bocur ltye*e«>ptto« is 

An object is accessed when one of the following byteeodes is executed using the object's reference; 

getf laid, putfleld, invoxavlrtual. invokelnterfaca , 
a throw, «T»eloaa, <T>aatom, arraylangth, ehnekeaat, inataneeof 
<T» refers to the various types of amy byteeodes, such as baload, aaatora, etc. 

This list includes any special or optimized forms of these byteeodes 'implemented in the Java Card VM, such as 
gat£iuld_b, agetf tald_a_thia, etc. 



6 . 1 .4 Firewall Protection 

The Java Card firewall provides protection against the most frequently anticipated security concern: developer 
mistakes and design oversights thai might allow sensitive data to be "leaked" to another applet An applet may 
be able to obtain an object reference from a publicly accessible location, but if the object is owned by a 
different applet, the firewall ensures security. 
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?|1 iwT.^Z.f' 1 *'™' T^,""^ w hided onto a card, the firewall 

still prottxts objects from being accessed by tnlt code. 

The Java Ctrd API 2.1 specifics the basic minimum protection requirement! of contexts and firewalls because 
these features snail be supported in ways that are not transparent to the applet developer. Developers snap be 
.ware of the behavior of objects, APiK axaj exceptions related to the firewall. 

JCRE implements i arc free to implement additional security mechanisms beyond those of the spplet firewall, 
ashng u these meehan.au, m transparent !0 applet. and <te not change the externally viable operation of the 

6. 1 .5 Static Fields and Methods 

It should also be noted that ctees are act otwsskJ by cnr. texts. Th«t it oo nsitime context check that can be 
perforated when a class static field is accessed. Neither is mere 8 context switch when a static method b 
invoked. (Similarly, lnvekeapacial causes no context switeh.) 

Public static fields and public static methods are accessible fro® any context static methods execute in the 
same context as their caller. 

Objects referenced in static fields are just regular objects. They are owned by whomever created them and 
swjdard firewall access rules apply. If it is necessary to share them across multiple applet contexts, then these 
objects need to be SkartoM, Interface Objecu (SIOs). (See paragraph 6.2.4 below.) 

? e technology protections are still enforced for static fields and methods. In 

addition, when applets are installed, the Installer verifies that each attempt to link to an external static field or 
method u permitted. Installation and specifics .bout linkage are beyond the scope of this specification. 

6.1.5.1 Optional static access checks 

The JCR£ may perform optional runtime checks that ar 

A Java Card VM may detect when code violates fundi* „„ s . 

method in another class, and report or otherwise address the violation. 



6.2 Object Access Across Contexts 

To amble applets to interact with each other and with the JCRE, some well-defined yet secure mechanisms are 
provided so one context can access an object belonging to soother antral 

These mechanisms are provided in die Java Card API 2.1 and are discuss*! in the following sections: 

• JCK£ Entry Point Objects 

• Global Arrays 

• JCRE Privileges 

• Shareable Interfaces 
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6.2.1 JCRE Entry Point Objects 



Secure computer systems shall hive a way for non-privileged titer processes (that are restricted te 
resources) to request system services performed by privileged "system" routines. 

In the Java Card API 2.1, this is accomplished using JCRE Entry Mm Objecu. These arc object! 
JCRE context, but they have teat fogged as eanatetng entry pant method*. 

The firewall protects these objects from access by applets. The entry point designation allow the 
these objects to be Invoked from any context. When that occurs, a context switch to the JCRE cor 
performed. These methods are the gateways through which applets request privileged JCRE system services. 

There are two categories of JCRE Entry Point Objects : 

» Temporary JCRE Entry Point Objects 

Lite all JCRE Entry Point Objects, methods of temporary JCRE Entry Point Objects can be invoked from 
My applet context However, references to these objects cannot be stored In class variables, instance 
variables or array components. The JCRE detects and restricts attempt! to store references to these objects 
so part of the firewall nraaiautliry to prevent unauthorised re-me. 

The APDU object and all JCRE owned exception objects are examples of temporary JCRE Entry Point 
Objects. 

• Permanent JCRE Entry Point Objects 

Uke all JCRE Entry Point Objects, methods of permanent JCRE Entry Point Objects ean be I 
any applet context. Additionally, references to these objecu can be stored and freely re-used. 
JCRE owned AID Instances are examples of permanent JCRE Entry Point Objects. 
The JCRE is responsible for. 

• Determining what privileged service! are provided to applets. 
» Defining classes containing the entry point method* for those services. 
» CtearJag one or more object instances of those classes. 
e Bessgrwring those feair.ee* as JCRE Entry Point Objects. 

• Designating JCRE Entry Point Objects si Sessfwrary o? permantBt 

• Milking references to (hose objects available to sppta si noeded. 



Note - Only the MWt of these objects are accessible through the Brcwall. The fields of these^ objects are atU 
protected by the firewall s^cmjjvjbejtecesj^^ — . 

Only the JCRE itself cm ft»igr*e Entry Pofet Objects «nd wtaste ftey are fetperery of raamentJCRE 
mpl^tesarerc^wifeSeforimpI* id •. aziml Mtk 1CKE Entry Poiot Objects are 
aaigiMiud ejrf how they boairae lempotwy or permanent 



6.2.2 Global Arrays 

The global nature of some s . 
ordinarily prevent these objects from bring wed i 



The Blobal awe of «>e objects requires that they be accessible front my applet context The firw*«Uw<^d 
. * « - — ftedt msasff.Thei aid VM sJtow* an object to be 



All global arrays an temporary global array objects. These objects are owned by the JCRE context, but , 
^^fromany appletWext However, tefenaces to these object, cannot be stored In class vb, »bl. 

&4 Co^eOac^M,1^SwH(Tl^Wfe 
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instance variables or array components. The JCRE detects and restricts sttanptt to So 
objects as part of the firewall functionality to prevent unauthorised revise. 

For added security, only arrays can be designated as global and only the JCRE itself < 

arrays. Because applets cannot create them, no API methods are defined. ' 

for Implementing the mechanism by which global mrayt m designated. 

a L™.^^ P "il e *? 0 rf * iJ£dfication ' *' ^ 8l<**J ways required in the J*va Card API 2. 1 are die 
APDU buffer and the byte array input parameter (bArray) to the applet) install method. 

a N o^.l^^ 0 bl^T.«T * C AP ' ,pecifi "*" *« APOU buffer is cleared touxoes whenever an ' " 
applet is Klwtod. before die JCRE accepts a new APDU command This is to prevent an applet's potentially 

warned from a shared mttrfacc object context and is suitable for passrtg &ss uress applet context!. The 

6.2.3 JCRE Privileges 

o^^^S^^^^T^*^^ 1 ^ "^voke a method of any 
!^*X^^S le r?T- S ?^Sf tX ««w«««*«H*«A- Normally, only context A can 
access (be fields and method, of X But the JCRE context is allowed to invoke any of the methods of X During 
such an mvocaUott, a context switch occurs from the JCRE context to the applet context that owns X 

JcSSSaSeSSr^SS 5 Method a °ce» is the mechanism by which me 

JCRE enters an applet context Although the JCRE could invoke any method through the firewall, it mall only 
Zt^SXSZZ?' ""^ »'^*™"'«*«c«»,.ct (~ 6-3.7. »)n>cd,od, 



^SSS^^T^ after a card reset The JCRE 

context ts the Toot context and is always either the currently active context or the bottom context saved on tl 



6.2.4 Shareable Interfaces 

Shamble imafaca area new Iwture in the Java Card API 2. 1 to enable applet interaction. A shareaUt 
interface defines a set of shared Interfax methods. These interface memodTcan be invoked from one to 
context even if the object implementing them Is owned by another applet context * 



To the twain* context, the SIO a normal object whose fields and methods can be accessed. To any other 
-tt, the SIO is an mstance of Ae shareable internee, and only the methods defined in the shareable 



inter&ce are accessible. All other fields end methods of the SIO are pt 



id by the firewall. 



To jamta m objee > •vailaUe to another sppte, spptet A first defines ■ durable imaftc*, SIA — 
mterfew extends the : tnterte j »vacard . fr.»ework . Shareable. The methods defined in me 
shareable tatirte^ SI. represe«me»ervic«tb*tappld An " 



ffi^cTr CfiMS d S C *? ta P 1 T*« tte **»»>>»« to«rf»« SL C implements & 
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4. To access applet A's object O. applet 0 creates «a object reference SJO of type SI. 

5. Applet B invokes a special method <JCSy«tei».g«itAi»lotSh*re*l>laIntorf aeaCfcj act, tkseribed si 

o-agraj 7.2) to r«qu share < t reference from applet A. 

6. Applet A receives the request end the AID of the requester (B) vis 

Applet . getShnroaJbleJ.nr.erf aeaOb j act, and determines whether or not it will share object O with 



?. if applet A agrees to share with applet B, A responds to the request with a reference 
cast to type Shareable so that none of the fields or methods of O are visible. 

8. Applet B receives the object reference from applet A, casta it to type SI, and stores it in object reference 
SIO. Even though SIO actually refers to A'f object 0. 510 is of type SL Only the shareable interface 
methods defined in Si are visible to B. The firewall prevents the other fields and methods of O from being 

accessed by B. 

9. Apple! B can request strvte from applet A by invoking one of the durable interface method* of SIO. 
During the in vocation the Java Card VM rterfbrnu a tor. tea switch, The origins! ejsnraatlv active context 
(B) is saved on a alack and the context of the owner (A) of the actual object (O) becomes the new cumstiy 
active context A's implementation of the shareable interface method (St method) executes in A'» context 



10. The Si method can find out the A© of its client (B) via the JCSysteta . ge tPreviouaContasctAIO 
method. This is described in paragraph 6.2.5. The method iHermbMS whether or not it will perform toe 
service for applet B. 

1 ! Because of the context switch, the firewall allows the SS method to access all the fields and metbo&t of 
object O and any other object owned by A. At the same time, the firewall prevents the method from 
accessing non-shared objects owned by B. 

12. The St method can access the parameters passed by B and can provide a return value to B. 

1 3. During the return, the Java Card VM performs a restoring context switch. The original currently active 
context (8; is popped from the (tack, and again becomes *e current context 

1 4. Because of the context switch, the firewall again allows B to access any of its objects and prevents 8 from 
accessing non-shared objects owned by A. 

6.2.5 Determining the Previous Context 

m the instance A ED of the 



6.2.5.1 The JCRE Context 

The JCRE context does not haw m AID. If an applet eallj the gatfrev* cusCsntaxtMB method when the 
applet context was entered directly from the JCRE contest, this method rttaas null . 

If the applet calls getPreviouaContextAID from a method that may be accessed either from within the 
applet itself or when accessed via a shareable interface from an external applet, it shall check for null return 
before performing caller AID autheedc&hon. 
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6.2.6 Shareable Interface Details 

A shareable interface is amply one (bat extendi (either directly or indirectly) the tagging interfere 

i avaeantS . fraoework .Shareable, This shareable faterface it similar fa concept to the Keooee interface 

used by the RMI finality, in which calls to the interface methods take place across a local/remote boundary. 

6.2.6. 1 The Java Card Shareable Interface 

Inter feces extending the Shareable tagging interface have this special property: calls to the interface 
methods take place across Java Card's applet firewall boundary via a context twitch. 

The Shareable interface serves to identify all shared objects. Any object that needs to be shared through the 
applet firewall shall directly or indirectly implement this interface. Only those methods specified in a shareable 
interface are available through the firewall 

Implementation classes can implement any number of shareable interfaces and can extend other shareable 
implementation classes. 

Like any Java platform interface, a shareable interface simply defines a set of service methods. A service 
provider dais declares that it "implements" the shareable interface and provides implementations for each of 
the service methods of the interface. A service client das accesses the services by obtaining an object 
"Sfi 06 " ****** " '° ^ * U ** bU lnta&a> lype ir °****n< and invoking the service methods of the 

The shareable interfaces within the Java Card technology shall have die following properties: 

• When a method in a shareable interface is invoked, a context switch occurs to the context of the object's 



• When the method exits, the cornea of the caller is rettared. 

• Exception handling is enhanced so that the currently active context is correctly restored during the stack 
frame unwinding that occurs as an exception is thrown. 



6.2.7 Obtaining Shareable Interface Objects 

Inter-applet communication is accomplished when a client applet invokes a shareable interface method of a SIO 
belonging to a server applet In order for this to work, there must be a way for the diem applet to obtain the SIO 
from the server applet in the first place. The JCRE provides a mechanism to make this possible. The applet 
class and the jcsyntem class provide methods to auMe a diem to request services from the server. 

6.2.7.1 The Method Applet .getShareablelnterfaceObject 

This method is implemented by the server applet insoutce. It shall be called by the JCRE to mediate between a 
client applet that requests to use an object belonging to another applet, and the server applet that makes its 
objects available for sharing. 

The default behavior shall return null, which indicates (bat an applet does not paredpate in irUtr-applct 
communication. 

A server applet that is intended to be invoked from another applet needs to override this method. This method 
should examine the ciiwncAIo and the parameter. If the ellencAJD is not one of the expected AlDs, the 
method should return null Similarly, if the parameter is not recognized or if it is not allowed for the 
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el lentAlo, thea the method also ihould return null. Otherwise, the apple* should return an SIO of the 
shareable Interface type thtt the client has requested. 

The server applet need not respond with the tune SIO to all clients- The server cm support multiple types of 
shared inter&ces for different purposes and use cHentMD end parameter to determine which kind of SIO 



6.2.7.2 The Method JCSystem.getAppletShareablelnterfaceObject 

The jesyscaa elans contains the method getAppletShareableintarlacraObject, which Is invoked by a 
client applet to ournmuaicale with a server applet. 

The JCRE shall smpiemeat ttti* method to behave as fellows: 

1 . The JCRE searches its interna! applet table for one with sarverJUB, If not found, null U returned. 

2. The JCRE invokes this applet's getShAreablalntertaceObjaet method, passing the ellentAID of 
the caller and the parameter, 

3. A context switch occurs to the server applet, and its implettuataiionofaetshereeirlelnterfaceobject 
proceeds as described in the previous section , The sever applet returns a SiO (or null). 

4. g «cAs5pletSh«-eatjlelnter£aceObjeet returns the same SIO (or null) to its caller. 

For enhanced security, the implementation shall make it impossible for the client to tell which of the following 
conditions caused a null value to be returned' 

» The serverJUO was not found. 

• The server applet does oat psrtitip«t« in twer-sppiMetJmmunicatieo. 

« The server applet does not recognize the cUeneAlo or the parameter. 

• The server applet won' t communicate with this client 

• The server applet won't communicate with this client as specified by the parameter. 



6.2.8 Class and Object Access Behavior 

A static class field is accessed when cine of (he following Java byteeodes is executed: 
gatetatlc, putatatie 

An object is aetetfed when one of the following Java byttcodes is executed using the object's reference: 

getrield, putrlald. lnveOtavlrtual. invmkelntarfaea, attars, 
<T>aload, «T m» a tare, arraylengtit, chec)ccaot, instanaioS 

<T> refers to the various types of array bytecodes, such as baload, imatora, etc. 

This list also includes any special or optimaed forms of these byteeedes that may be implemented in the Java 
Card VM, such as get£i8isJ_b, Bget£I«ild_8_thiB, etc 

Prior to performing <he wmk of die bytecoSe sj specified by the Java VM, the Java Card VM will perform an 
access check on the referenced object If access is dented, (hen a SaeurityBxeeption is thrown. 

The access checks performed by the Java Card VM depend en the type and owner of the referenced object, the 
bytecode, and the currently active contort. They are described m the following sections. 



S*S Copyfitfit © Dacembflf 14, 18S8 Sun Mtarosystartis, inc. 



SUBSTITUTE SHEET (RULE 26) 



WON/45262 



PCTYUSOO/01234 



43 

Java card ™ Rumuae Environmem (JCRE) 2.5 Specification 

6.2.8. 1 Accessing Static Class Fields 
Bytecodw 

■ If the JCRE is the currently eetire context, then access U sllovred 

■ Otherwise, if the bytecode is putstatic sad the field betas stored is a type an4 the reference 
being stored is » reference to a temporary JCRE Entry Point Object or s global array then access is denied 

B Otherwise, aeceuu allowed. 



6.2.8.2 Accessing Aitay Objects 



«T»al<Mul. <T>-a store, airey length, checkeaae, Inaeaaccof 
8 If the JCRE is the currently active cants*!, then socea it allowed 

■ Otherwise, if the byieeoae is eaacore ana the component being stored U a reference type and As 
reference being stored is a reference to a temporary JCWE Entry Point Object or » global array then 
it denied 

B Otherwise, if the array i« owned by the currently active context, then access is allowed. 
B Otherwise, if the array is designated global, then acceu is allowed. 



6.2.8.3 Accessing Class Instance Object Fields 
Byteeodes: 

gstfidld, puefleld 

Si If the JCRE is the currently active context, then scees 
Otherwise, if die bytecode a put£i aid and die 
being stared is a reference to a temporary JCRE 
B Otherwise if die object is owned by the currently active context, then access is allowed. 
B Otherwise, access is denied 

6.2.8.4 Accessing Class Instance Object Methods 



B Otherwise, if die bytecode a putfi.ld and the field being stored is a reference type and the reference 
being stored is a reference to a temporary JCRE Entry Point Object or i global array then sows is denice 



■ I* ** » WM< by «he wrm&y eewew, then «oee« it altowtd Ccntew is rmtcbtd to &t 
object owner's eon too, 

B Otherwise, if fee object is designated a JCRE Entry Point Object, (hen access is allowed. Contact is 
switched to the object owner's context (shall be JCRE). 
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■ Otherwise, if JCRE is the currently active certtext. then access is allowed. Context is switched to the object 
owner's contort. 



6.2.8.5 Accessing Standard Interface Methods 
Byteeodes: 

tnvokeineerfaca 

■ If the abject is owned by the currently active context, then access is allowed. 

• Otberwitt, if the JCRE is the currently active context then assess is allowed. Context is twitched to the 
o^acs owner's context 

■ Otherwise, access is denied. 

6.2.8.6 Accessing Shareable Interface Methods 
Byteeodes: 

invokeinterfaca 

m If the object is owned by the currently active context, then access is allowed. 

■ Otherwise, if the object's class implements a Shareable interface, and if the interface being invoked 
exteadf the Shareable interfeoe, then access is allowed. Context is switched to the object owner'! 

■ Otherwise, if the JCRE is the currently active context, then access it allowed. Context is switched to the 
object owner's context 

■ Otherwise, access is denied. 



6-10 C<3pyrtgm© DaMfflbsr 14. 1898 Sun M-erosystums, ins. 



SUBSTITUTE SHEET (ROUE 26) 



WO 00/45262 



PC17US00/01234 



45 

Java ™ Card tm Runtime Environment (JCRE) 2.1 Specification 



6.2.8.7 Throwing Exertion Objects 



M if the abject is owned by the currently saivt somea, then ssotess is ailcKred, 

■ Otherwise, if the object is designated s JCRE Entry Point Object, then access U 

■ Otherwise, if the JCRE is the currently active context, then aectss is allowed. 

■ Otherwise, access is denied. 

6.2.8.8 Accessing Class Instance Objects 
Byt erodes: 



■ If the object is owned by the currently active context, then mxtss Si tiistwai 

■ Otherwise, if JCRE is the currently active context, then access is allowed 

■ Otherwise, if the object is designated a JCRE Entry Point Object, then acces 

■ Otherwise, if the JCRE is (he currently active context, then aeww m a!!ow« 



6.2.8.9 Accessing Standard Interfaces 



■ if the object it owned by the craroitiy active contest, thai as 

■ Otherwise, if the JCRE U 

■ Otherwise, access is denied. 

6.2.8.10 Accessing Shareable Interfaces 



■ If the object is owned by the currently active context, thea scan is allowed 

■ Otherwise, if the object's class implements a stuuraable interface, andifth* object is being east into 
(ehrekeass) « is aa iwanee of (instanced) an interface that extendi the Sharaabla interface, then access 
{sallowed 

■ Otherwise, If a»e JCRE is the cwrentty active context, then access is allowed 

■ Otherwise, access is denied 
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6.3 Transient Objects and Applet contexts 

Transient objects of Ct^AR_0N_R2SET type behave like persistent opsonin that they am be accessed only 
when the currently active applet context it the nme as the owner of the object (the currently active applet 
contest at the time when the object was created). 

Transient objects of CLEAR ONJDESELECT type can only be created or accessed when the currently active 
applet context is the currently selected applet context If my or the maJceTranoieat ftctory methods is 
called to create a CLEAR_ON_DF.SEI.ECT type transient object when the currently active applet context is not 
the currently selected applet context, the method shall throw a SystetaExcaption with reason code of 
ILLEGAL TRANS IENT. If an attempt it made to access a mnaest object of CLSAR_OIJ_DESEtECT type 
when the currently active applet context is not the currently selected applet context, the JCRE shall throw s 
Secur ityExcept ion. 

Applm that are part of the same package share the same group context. Every applet instance from a package 
shares all its object instances with all other Instances from the same package. (This includes transient objects of 
both cl£AR_on_R£SET type and CL£AR_OH_DE£ ELECT type owned by these applet instances.) 

The ftunsient objects of CLEAR_ON_DESELECT type owned by my applet instance within the asms p&dauw 
shall be accessible when any oflhe applet instances in this package is the currently selected applet 
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7. Transactions and Atomicity 



a logical set of updates of persistent data. Tm ewmple, trmsfarwg some .mount of money 
meTTliT^^ZS" 11 * * if*?" " M " 1 ^ ** ^™<m to be wmic; after aU of 

*e data fid* arc updated, or none art. The JCRE provides robust support for atomic transactions, so that card 

midunum protects against events such as power Ion in the middle of a transaction, and a " 
that might cause data corruption should all steps of a transaction not complete normally. 



7.1 Atomicity 

Atomicity defines how the card bandies the contents of persistent storage after a stop, failure, or fatal kccmUu 



The Java Card platform guarantees that any update to a single perostrnt object or class fide „,„ , ..... .. 

addmon. to ).« Card platform provides single component level atomic^ for pemstem arr»~ Tto£tt*t 
mm, card loses power during the update of a data element (field in an obje*clk»or component of an array) 
that shall be preserved across CAD sessions, that data element wiil be roCi to it. pr^o^iul W 

s atomicity (or block updates of multiple data elements. For example, the atomicity 
shod guarantees that either all bytes are correctly copied or else the destination 
— , — r.v.rajs byte values. 

An applet might not require atomicity for array updates. The otil .asrayajpyNoafctoatc method is provided 
for mil purpo*. It doer not we *e Oanswion commit buffer even when Sited with a o™Sln pro^k 



7.2 Transactions 

A^la might need to atotnically update several different fields or array component, m several different 
5Sr ittltPl,ECHMW£mi,,nl1 '' " *"* ^wnpo^hi are restored to 

The Java Card platform support! a transactional model in which an applet can designate the beginnme of an 
■Mac set of updates *ith a cell to the JCSyae^stnTranaaction method. laTob/ecVupZ afta Tmis 

Copyti^O December 14. 1998 Sun Microsystems, inc. 7-1 



SUBSTITUTE SHEET (RULE 26) 



WO 00/45261 



47/1 



PCTAJS00/O1234 



Java ™ Card ™ Runtime Environment (JCRE) 2, 1 Specification 

ig the field/array 



When the applet calls JCSystem .eoamitTranaaetion, ail conditional update* are c fur, 
storage. If power is lost or if some oth«x system Sulure occurs prior to the conpletion of 
JCSyatem.cc^tTran.actlon, all c di at fields or array eor onea are restnred t 

prevtous values. Ifthe applet encctmtas an internal problem or dedda to eancdTe taw tic. . 



73 Transaction Duration 

A transaction always ends when the JCRE regaina programmatic control upon return Sow the applet', .elect, 
deselect, proems or lnatall methods.. This is true whether a transaction cods normally, with an applet's 
rail to coral tlx arm act ion, or with an abortion of the transaction (either orommmatieaily hv the armlet n 
by default by the JCRE). For more detail* on transaction abort*, refer mplm^lA W 

Ttatmction duration is the life of 



7.4 Nested Transactions 

The model currently assumes that nested transactions are not possible. There can be only one transaction in 
erogresi at a time. If JCSy»tera.beginTr«nj>«ction is called while a transaction is already in-progreas, Act 
aTrasuactlonBxeeptlon II thrown. 

The JCSyateto . trM»»a>cesoaD*pth method a provided to allow you to detesraine if a transaction is in 



7 .5 Tear or Reset Transaction Failure 



the previous call to JCJysee 

This action is formed autctmtittiiy by the JCR£ whm it fanrriaiizes the card after 
power loss, reset, or failure. The JCRE determines which of those objects (If any) went conditionally updated, 

Note - Object space used by instances crested dining the muuactm to foiled due to power loss or card reset 
■EHj'"*! recovered by the JCRE. 
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7.6 Aborting a Transaction 

Transactions can be aborted either by an applet or by the JCRE. 

7.6.1 Programmatic Abortion 

If an applet encounters an internal problem or decide* to cancel the transaction, it can progwnmatJcally undo 
conditional updates by calling JCSy a t em . sUwrt Transact ion. If this method Is called, all conditionally 
updated fields and array components since the previous call to JCSyatem.beginTrana.ction are restored w 
toetr prevtouss values, and the JCSyBtem.tiraassctioaCapth value b reset to 0. 

7.6.2 Abortion by the JCRE 

If an applet returns from the select, deselect, process , or inaeall methods with a oansacdofl in 
progress, the JCRE automatically aborts the transaction. Ifa return from any of select, deselect, proceao 
or install methods occurs with 8 inrisactior. in progress, the JCRE sea as if an exception was thrown, 

7.6.3 Cleanup Responsibilities of the JCRE 

Object instances created during the transaction that Is being aborted can be deleted only if all references to these 
objects can be located and converted into mill . The JCRE shall ensure mat references to objects crested 
during the aborted transaction are equivalent lot null reference. 



.7.7 Transient Obj ects 

Only updates to persistent objects participate in the transaction. Update, to transient objects arenever undone. 



7.8 Commit Capacity 

Since platform resources are limited, the number of bytes of conditionally updated data thai can be accumulated 
during a transaction is limited The Java Card technology provides methods to determine how much commit 
avoetr, b ailable on the imputation. The commit opacity represent, an upper bound on the number of 
« byte updates available. The actual number of conditional byte updates svsilable rray be lower (Jus 



An exception b thrown if the commit capacity is exceeded during a i 
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8. API Topics 



The ; epics is this chanter complement the resnrir emmts specified in *e /tmi Cerd 2. 1 API Draft 2 
Specification. The first topic is the Java Card I/O fMcrioiuiity, which is implemented entirely in *e APDU class. 
The second topic i> the API supporting Java Card security and cryptography. The JCSyate* class encapsulates 
the API version level. 

Transactions within the API 

Unless specifically called out in the/ova Card 2.1 API Specification, (he bjtplemoitarion of the API classes 
sfrai! rot initiate or otherwise alter the state of a transaction if one b in progress. 

Resource Use within the API 

Unless specifically called out in the Java Card 2.1 API Specification, the impt< 
invocation of API instance methods, even when the owner of the object ir«e«m 
applet in other words, unless specifically called out, the irnplemsitttkm 
transient objects of OEAIL.ON„DESELECT type. 

Exceptions thrown by API daasaa 

All exception objects thrown by the API implementation shall be temporary JCRE Entry Point Objects. 
Temporary JCRE Entry Point Objects cannot be stored in class variables, instance variables or array 
■■is. (Seefi.il) 



8.1 The APDU Class 

The ajrotj dasi encapsulates access to the ISO 78 1 6-4 based I/O across the card serial line. The APDU Class is 
designed to be independent of the underlying I/O transport protocol. 
The JCRE may support T«0 or T-l transport protocols or bosh. 

8.1.1 T=0 specifics for outgoing data transfers 

For compatibility with legacy CAD/terminal* that do not support block chained mechanisms the JU>DU Class 
allows mode selection via the eet0uegoingHaC3iaining method 
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8.1.1.1 Constrained transfers with no chaining 

When the no chaining mode of output transfer it requested by the applet by calling the 
BBtOutgoiagHoChalrting method, the following protocol sequence shall be followed 



Note - when the no chaining mode it used, calb to the waiEEsCenaion rarfwd shall throw an 
AFPTJExeept ion with reason cod e IU.EO ALD OSE. 



Notation 

Le « CAD expected length. 

Lr » Applet response length set via aetOutgolng Length method. 

<INS> - the protocol byte equal to the incoming header IKS byte, which indicates diet all date byte* 
will be transferred next. 

<~ jns> - the protocol byte that is the complement of the incoming header DNS byte, which indicates 
about 1 data byte being transferred neat 

«SWl,SW2>» the response status bytes ssinfSOTSIM. 



ISO 781&4 CASE 2 
Le«=Lr 

1 . The card tends Lr byles of output data using the gOJKfcrd T-0 <INS> or <~INS> procedure 
byte mechanism. 

2. The card sends <SW I, SW2> completion status on completion of the Applftfc .process 



Lr<Le 

1. The card sends «ht6IJLr> completion status bytes 

2 . The CAD sends GET RESPONSE command wi&Le-Lr. 

3. The card Sends Lr bytes of output data using the standard TK> <TNS> or «-lN3> procedure 
byte mechanism. 

4. The card sends <SW I ,SW2> completion mom m completioo of the Applet . process 
method 



U»le 

1. The card sends Le bytes of output data using the standard T«0 <TNS> or <HNS> 
procedure byte mechanism. 

2. The card sends <Ox61,(Lr-L*)> completion state bytes 

3. The CAD sends GET RESPONSE eomawnd with new U <- Lr. 

4. The card sends (new) Le bytes of output c^uxmgmcc&nda(dTH><INS>ar«<INS> 
procedure byte medtwan. 
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1 Repeat steps 2-4 as necessary to send the remaining output data bytes <U» as fluffed 
6. He card sends <SWi,SW2> eanjHeticm «*&« co completion of the Applet . proceed 

ISO 7816-4 CASE 4 

la Case 4, U is determined after the following initial exchange 

!. The card tends <0x6l,Lr status bytes> 
2. The CAD sends GET RESPONSE command with La <- Lr. 
The rest of the protocol sequence is identical to CASE 2 described above. 

M instead to fill out the length of the 



8.1.1.2 Regular Output transfers 

When the no chaining mode of output transfer is not requested by the applet (that is, the ««tOutgoiag 
method is used), the following protocol sequence shall be followed: 

Any ISO-78 16-3/4 compliant T«0 protocol transfer sequence may be used. 

Nolo - The waitExtena ion method may be invoked by the applet between successive calls to eendBytea 
or BendBytaaLong methods. The waitEstennion method shall rtquea an additional work waiting time 

*«t5j^^S2iJ2L. - - 

8.1.1.3 Additional T-=0 requirements 

At any time, when the T-0 output transfer protocol Is in use. and the APDU class is awaiting a GET 

RESPONSE command from the CAD in reaction to a response status of <0%6 1, xx> from the card, if the CAD 
sends in a different command, the aendsytea or the oandByeeaUsng methods shall throw an 

•i /~:L?_V!'<5pv.ion with reason rode NO TO OSTRBSPOMSE. 

Calls W sendByeea or eendflytmBUms methods from thU point en shall result in an APDOExeeption with 
reason code ILLEGAL OSB. If in ISOExcapt ion Is thrown by the applet after the MO_T0_OETSE8POMSB 
exception hMl^ thrown, the JCRE shall discard the response status in its reason code. The J CRE shall restart 
APDU processing with the newly received command and resume APDU dispatching. 

8.1.2 T=l specifics for outgoing data transfers 

8.1.2.1 Constrained transfers with no chaining 

When the no chaining mode of output transfer is requested by the applet by calling the 
actOutgoingNoOtainirig method, me following protocol sequence shall be followed 

Notation 

Le m CAD expected length. 

Lr « Applet response lengSt set via aetOutgoingLength method 
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The »M?wi lWiiil wnience shall not u« block chaining. Spedfieally, the M-bit (mere data bit) shall not be 



Note - When the no chaining mode is used, calls to the waitExteaeiaa method shall ft 
APPUE xcapt loa wit h reasofl code_IU^OAt_qSK. 



8.1.2.2 Regular Output transfers 

When we so ehwausg mode ofoutpu 
used, the following protocol sequence 

MyiSO-7$l6-S/4ccmpUentT"l protoool transfer sojuence may be ywd 



^T.?',®!! d ^ inin8 m0de rf ""^ aanifa * n< « requested by the applet Lc the setOutgoino method is 
used, the following protocol sesjuraos shaft be followed: 



5(8 ~ T * e waitExtenaion method may be invoked by the applet between successive calti to sendBytea 
oendflytesLong methods. The waitExtsna ion method shall send to S-btock command with V7TX 
of INF units, which is equmlc. to s requw of 1 adding work waitwg tiro in T«0 mode. (See ISO 



781_6-3). 



8.2 The security and crypto packages 

mentation instance in the contort of the 

i avacedrd . aeicur i ty . MeasageDigea t 
j «v«c*rd . security. Signature 
Javacsrd. security. lUndotnDafca 
3 avaeartx . crypto . Ciphar. 

An tmploaeotaoon of me JCRE may implement 0 or more of the algorithms listed in the API. When an 
algorithm that it not implemented U requeued this method shall throw a CryptoBxceptten with reason 

«de NojsoajjusQsuraR 



. , 41 , . 111 weadiirecOTtspondjagbuwdassst^ 

meftods. AH data allocaiKm a»soei»t*4 with the iinptamtntarion instance shall be performed*! the time of 
toJtaace conitoieticn to tn»w thw 
the applet 

Swlte'ly, me buUdKay method of the Javacard.nacurlty. kayBuildax cbss reams an 
tmplasra*! ■« «m *mm of the requested Key type. Tie JCRE may implement 0 or more types of keys. Wta a 
key type that is not implement-* « * ■ -•--«• «— - • ■ r ■ ■ 
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Implementations of key type, shall implement the manned inttrtsct All data allocation associated with (he 
key implementation instance shall be performed U the time of instance construction to ensure that any lack of 
required resource* can be flagged early during the installation of the applet. 



8,3 JCSystem Class 

in Java Card II. the getveraico method shall return (short) 0x020 1 . 
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9. Virtual Machine Topics 



Tht topic* in this chapter detail virtual machine specifics. 



9. 1 Resource Failures 

A tack of resource! condition (such as heap space) which is recoverable stall result in a Sy»cemHxcej>tion 
with reason code ko_r*source. The factory methods in jesyacea used to create transient arrays throw a 
SyutemExceptton with reason code HQjriuwsiSNT_SFACS to indicate tack of transient apace. 

All other (dsn-recoverable) virtual machine errors such as stack overflow shall result in a virtual machine error. 
These conditions shall cause the virtual machine to hah. When such a nawccovcrabls virtual machine art* 
" m optionally require the card to be muted or blocked from further use. 
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10. Applet Installer 



Applet installation on smart cards using Java Card technology is a complex topic. The Java Card API 2.1 is 
intended to give JCRE implemeaters as much freedom u possible in their Implementations. However, tome 
banc common specifications are required in order to allow Java Card applets to be in Railed without knowing 
the implementation details of a particular installer. 

This specification defines the concept of an Installer and specifies minimal installation requirement* in order to 
achieve interoperability across a wide range of possible Installs- implementations;. 

The Applet Installer is an optional pan of the JCRE 2. 1 Specification. That is, an implementation of the JCRE 
does not necessarily need to include a post-issuance Installer. However, If implemented, the installer is required 
to support the behavior specified in section 9. 1 . 



10.1 The Installer 

it cards using Java Card technology are embodied in an 

To the CAD the Installer ippej Hot i appli if t-> i iD ai lith <•§-. ^s, i xrenli) ^elected applet 
when this AID is successfully praewtsed by a SELECT ctmmand. Once selected, the Installer behaves in much 
the same way as any other applet 

• It receives ail APDUs just 13a! any other selected applet. 
Its design specification prescribes the various kinds and formats of APDUs that It expects to receive along 
with the tcrntntics of these commands under various -nditjom. 

• It processes and responds to all APDUs that it receives. Incorrect APDUs are responded to with an error 



10.1.1 Installer Implementation 

The Installer need not be implemented as an applet on the card. The requirement is only thai the Installer 
functionaBry be SELECTable. The corollary to thlsrequiremeni U that Installer component shall not be able to 

be invoked when a non-Installer applet is selected nor when no applet is selected. 
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Obviouiiy. a JCRE implementef could choose to implement the Installer as m applrt. If so, dust the Installer 
might be coded to extend the Applet dan and respond to invocations of the an lace, process, and 
deadest methods. 

But a JCRE fatplanenter could also implement die Installer in other ways, a* long as ft provides the 
SELECTabte behavior to the outside world In this case, the JCRE impiementer has the freedom to provide 
seme other mechanism by which APDUs are delivered to the buuiier code module. 

10.1.2 Installer AID 



10.1.3 Installer APDUs 



• Recognize the cant 

• SE1ECT the Installer on the csri. 

« Drive the installation process by sending the appropriate APDUs to the card Installer. These APDUs wii! 

> A«thcwi«tioa informHion, to erawe that the installation i» authorii«i 

> The applet code to be loaded into the card's manor/, 

> Linage information to link the applet code with code already on the card. 

> Instance Initialization parameter data to be sent to the applet's install method. 

The Java Card API 2.1 does not specify the details of the CAD mstsHstion program nor the APDUs 



1 0. 1 .4 Installer Behavior 

JCRE trap! entailers shall also define other behaviors of their InEtsJita, including: 

* .V»itt?.qr ss not installation can be abated and how this is done, 

« What happens if an exception, reset, or power tail occurs dtsfci snsraJl&Skjn. 

• Wbat happens if another applet is selected before the Installer is finished with its work. 

The JCRE shall guarantee that an applet will nor be deemed successfully is nailed if: 

ra from the Applet, register 
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10. 1 .5 Installer Privileges 

Although an Inflate may be implemented as an applet, an Installer wilt typically require access to feature! that 
are not available to "other applets. For example, depending on the JCRE implementer's implementation, the 
Installer will need to: 



a Read and wri te direcsiy to memory, bypassing the object system and/or standard security. 



• Access objects owned by other applets or by the JCRE. 

• invoke non-entry point methods of the JCRE. 

• Be able to invoke the install method of a newly installed applet 

Again, it it up to each JCRE iinplanenter to determine the Installer implementation and supply such features in 
their JCRE implementaacns iu necessary to support their basilar. JCRE impismenter* are alto responsible far 
the security of such feature*, so that they are not available to normal applets. 



There is a single interface between the Installer and the applet that is being installed. After the Installer has 
correctly prepared the applet tor execution (performed steps such as loading and linking), the Installer shall 
Invoke the applet's install method. This method is defined in the Applet class. 

The precise mechanism by which an applet's install method it inveteS from the Installer is a JCRE 
implements -defined Implementation detail . However, there shall be i context switch so that any contest- 
related operations performed by the install method (such as creating new objects) are dene in the context of 
the new applet and not in the context of the Installer. The Installer stall also ensure that array objects created 
during applet class initialization (<ctiniP) methods are also owned by the context of the new applet 

The installation of an applet is deemed complete If all steps are completed without failure or an exception being 
thrown, up to and including successful mum from executing the Applet . s-egiatar method. At that point, the 
installed applet will be selectable. 

The maximum lite of the parameter data is 32 bytes. And for security reasons. thehArray parameter is JKroed 
after the return (just as the APDU buffer is zeroed on return from an applet's proceaa method) 



10.2.1 Installation Parameters 

Other than the maximum aire of 32 bytes, the Java Card API 1. 1 does not specify anything about the contents 
of the installation parameter byte array segment This It firily defined by the applet designer and tan be in »ny 
format desired In addition, these installation parameters arc intendedto be opaque to the Installer. 

JCRE Implanon ten should design their Installers so that it is possible for an installation program running in a 
CAD to specify an arbitrary byte amy to be delivered to the Installer. The Installer simply forwards this byte 
array to the target applet's trial* 11 method in the Mtxay parameter. A typical tm pi emanation might define a 
JCRE imjjleati enter-proprietary APDU command that has the semantics "call the applet's install method 
passing the contents of the accompanying byte array." 




10.2 The Newly Installed Applet 
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11. API Constants 



Some of the API classes don't have value* specified for their constants in Ac Java Card API 2.1 Refmnce. If 
constant values are not specified consistently by implemcntcr* of this JCRE Z. I Specification, industry-wide 
interoperability is impossible. This chapter provides the required values for constants that are not specified in 
the Java Card API 2.1 Reference, 



Class javacanj.frasTiBworttAPDU 

public static final byte SKOTOOOLjrO - Oi 
public static flruU byte PROTOCQI.jn . V, 

Class javacart.framoworicAPDUExcsption 

public static final abort m.EO*£._B8E • li 

public static final abort BOTFBR aoONBS « ar 

public static final abort BMLKSOTH - 1, 

public static final abort IOJ5RKC* . t, 

public static final abort tW_T0_QETMSBOHSB « OxWW 

Interferes |av»canlnw9woriaS078ie 

public final static abort SH SO ERROR • (ahorttOxSOOO) 

public final static abort SW^BTTBS J«MMBIHa_Q <3 - 0x4100/ 

publte final static abort 5*f W*3IW_«J(KOH) » 6x6700) 

public static final abort SH SECOKOTf STATUS ROT SftXISFIBD « Ox«»83; 

public final static abort St£rXI,B_XBvixXD . Ox«»¥j> 

public final static short SWJDMfc ZNVftUD » 0x«S8«, 

public final atatic abort SW„OOTJTIOBS_W3T_swtISFiro - Oxjjgs, 

public final static attest S«_OCWKAS0_S0T_llLUWKD - Ow5»S6i 

public final static abort SW_*PPLBt_8BI«CT_F/UtUSB ■ s>k«S99j 

public final static abort SMJOttnajMXA ■ 0x6*60, 

public final static abort S\S_FIHC. tOT_SCPK»TKD - OjtfASl ( 

public final static short SXIJfXJMjmjKliaat . 0x«A8a, 

public final static abort SW MC5aHD_ROT PO0MD - 0XKM3) 

public final static abort 8*_IHC0»MCT_M.M - 0X*A»«) 

public final static abort SW_*ROWJ_PlPa • 0x6800) 

public final static abort 8W_O0RR8CT_Lsmoto 00 • OxiCOOr 

public final atatic abort Stt JMjmjSonatttD - OxSBOBj 

public final static abort SW.CXA WJT.SOTPOKTKD » SkSSso, 

public final atatic abort BV_mm>VH • OxCPOO) 

public static final short SW PILB POLL • 0xSA84; 

public final static byte OFPSST_aA - 0 ( 

public final static byte OFTOSX IBB - ii 

public final atatic byte orPSET.Pl - 2i 

public final static byte omrr_Pa . J, 
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public final static byte OPFSBT_LC « 4, 

public final static byte OPPSrrj3)MA- s, 

public tiaal static byte CtA_JS0781« - 0x00, 

public final static byte IMS SE1£CT - (byte! 0xA4i 

public final static byte IMS_EXTEJUOVl._AtnHSlfTICATE » ibyte) OkbJ; 

Ctass JavBCSfd-framawof k JCSystem 

public static final byte NOT_A_TRXMSIEKt_OBJECT • 0; 
public static final byte CLEAKJU^RXSET - 1, 
public static final byte CL£AS_OH_tmfi£U!CT . a ; 

Class javaeard.framaworkPINExceptlon 

public static final short ILU!CAJ._VAU78 . 1, 
« I ,i 1 d « „;i>iirii -^samException 

public static final abort lIAXOALJJtJXm . 1; 

public static final short NQ_TRAKSIBKr_SPAC2 - a< 

public Static final short ttEBOALTRAHSXENT • If 

public static final short ILLEGW._AJD - 4; 

public static final Ghort MO_RESOURCS . 5; 

Ciass javacard.seeuflty.CfyptoExaapaon 

public atacic final short IUJRGAI. VXKJE - li 
public static final short tMI!itTl*AIZBD_KEY • a, 
public static final short HO_SBCH_AU»RITO« - l! 
public static final snort INVAilOJCMIT - 4: 
public static final short XUAGALJBB - 5i 

Ciaw javacard.securtty.KeyBuIiiter 

public static final byes VCn DES WUUISIBKT_R8SBT - li 
public static final byte TYPB~DES_TR*MEI EHTJJBSEXXCT . 2; 
public static final byte Tn>B~DEs"« li 
public static final byte TYPEJtSA POBLXC - 4j 
public static final byte TYPE_RSA_ PRIVATE - Si 
public static final byte TBI! RBA_CRT_PRIVATE - Si 
public static final byte TrPEJJSAJPOBt.XC « ?j 
public static final byte TW>E_&SA_ PRIVATE - 8, 
ublie eta I - sai *roit DKS • «4i 

public static final snort tMKHM_0ESl_3!«1f - 12»i 
public static final short Utttcrra~DKSJ_Jianf • 192; 
public static final short UH«llJtSft.SU - SUi 
public static final short UBSOOlJtsyjM - 
public static final short LKHOTH_RSA_103« . 1024, 
public static final short U2»OTa_RHA_J04 8 • ao*B t 
public static final short i£KmS_nSA_SlJ - 5U| 
public static final short XJ»wrH_DSA_?«» * ->48i 
public static final short LBSOTK._DSA_102« . 1024 1 

Class jovacard.aocurtty^saageDlgosI 
public static final byte AXO_SKA • It 
public static final byte AI0.KDS - 2, 
public static final byte AM_RXPWDi(0 - 3i 

<lemData 

public static final byte AU3_Pfi&Tn»_B»HOON « li 
public static final byte &UJKCM.M1O0M - 2, 

Class (avocardJiacurity.SiawrtKfw 

public static final byte AXO OES KAC4_HOPAD - l ( 
public static final byte AM BBS HACO.MOPAO • ti 

public static finsl byte AM_D88_KAC4_IS097S 7_M1 • 3, 
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public static final bySe AW» £>J£S KAC8 ISOS797 Ki - 4, 

public static final bye a Md~DBS~KACi - I8097S7~ta » $, 

public Static final byta AU2 DBS~MAC9~IS097Si"k2 » «, 

public static final byte MO~PES~MAC4~FKCSS .~7, 

public static final byte ALS_DES MACS PKCSS • 8< 

public static final byes AUJ~RSiTsKA ISOS7SS - Si 

public static final byta AM~RSA _ SH*~PKCSl « 10< 

public static fiaal byte AM~RSA~KDs"*MCCSl « u, 

public static final byte AMJISAJIIpSkdiso ISOS7S4 . u, 

public static final byte AWJtSAJUPEHDlSO ?!CCSi « u, 

public static final byte MJ3 DS* SKA > n,~ 

Public static fizui byte NODE 81.5m . 1, 

public static final byte H0D8_VERXFY • 2/ 

Class javaeardxusypto.Cipher 

public static fiaal byte Ma DSS CSC HOPi* . 1, 

public static final byta Ma~BE8~CBC~lSO»797 Ml • 2i 

public static final byte ALQ~DES~CBc2lSO«7 $ 7~« » i, 

public static final byte fd/2 DBS CBC~J>KCS5 «~4r 

public static final byte Jua~D8S~EC»~H0»AD • s / 

public static final byte AW_OB8_SCB~rSO»7»7 HI > Si 

public static final byte *UljMES~SC8 - ISO»797~Ha . 7( 

public static final byte W3~DBS~BC8~FXC3$ -~Si 

public static final byte Ata~RSA~ISol4S8S . S; 

public static final byte MajLStTvKCBl • 10; 

public static final byte MOD8 DSGRYFT - 1; 

public static final byte MODB~ENOtypT « J, 
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Glossary 



AID is an acronym for Application IDeatifier as defined in ISO 7816-5. 

APDU is an acronym for Application Protocol Data Unh as defined in ISO 78 1 6-4. 

API is an acronym for Application Programming Interfere. The API defines railing conventions by which an 
application program acetates the operating system and other services. 

Apple! wiAin the context of this document means s Java Card Applet, which is the basic unit of selection, 
context, functionality, and security in Java Card technology. 

Applet developer refers to a person creating a Java Card applet using the Java Card technology specifications. 

Applet firewall is the mechanism hi the Java Card technology by which the VM prevents an applet from 
making unauthorized accesses to objects owned by other applet contexts or the JCRE context, and reports or 
utl.i -.vise addresses the violation. 

Atomic operation is an operation that either complete* in its entirety (if the operation succeeds) or no pan of 
the operation complete* at all (if the operation fails). 

Atomicity refers to whether a particular operation is atomic or not and is necessary for proper data recovery in 
cases in which power is lost or the card Is unexpectedly removed from the CAD. 

ATR is an acronym for Answer to Raset Aa ATR is a sirmg of bytes sent by the Java Card after a re sr. 
condition. 

CAD is an acronym for Card Acceptance Device. The CAD is the device in which the card is inserted 
Cnutf is the explicit conversion from one data type to another. 

rJCK la the test suite to verify the compliance of the tntpleroentatkn of the Java Card Technology 
specifications. The ciCK uses the JsvxTcrt tool to run Ae test mats. 

CUas ia the prototype for an object in an object-oriented language. A class may also be considered a set of 
objects that share a common structure and behavior. The structure of a class ia determined by the class variables 
that represent (he rute of an object of that class and the behavior is given byaset of methods associated with 
the class- 

Clause* are related in a class hierarchy. One diva may be a spcoiaJteatiea (• subclass) of another (to 
superclass), it may have reference to other daasas, and it may use other dMjs ia a clitnt-server relationship. 

Coateit (Sea Applet execution context) 

Currently active contest. The JCRE keeps track of the currently active Java Card applet context. When a 
virtual raelhod is invoked on an object, and a context switch is required and permitted, the currently active 
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««atext is changed to correspond to the applet context that owm she object. When that method returast, the 
previous contest is restored Ui vocations of atsric methods hsvn ho effect m the currently active context The 
currently active contact tnd sharing status of an object together determine if eccesi to in object is pemussible. 

Caraittty selected applet The JCRE keeps trade of the currently selected Java Card applet Upon receiving a 
SELECT command with this applet's AID, the JCRE makes this applet the currently selected applet The JCRE 
amis aJl APDU tmmamds to the currently selected applet 

EEPROM is an acronym for Beotrisally Erasable. Programmable Read Only Memory. 
Flnwalt (see Applet Firewall). 



GsvtagK wSfc»ta»?i >a shs proses by which dynamically allocated swage h sutomaacatly lectaimed (faring 



Instance variables, alto known as fields, represent a portion of an object's internal tats. Each object has its 
own set of instance variables. Objects of the tame class will have the same instance variables, but each object 
can have different values. 

Instantiation, in object-oriented programming, means So produce a particular object from its class template. 
This involves allocation of a data structure with the types specified by the template, and initialization of 
iasunee variables with either default values or those provided by the diss's constructor function. 

JAR is an acronym for Java Archive. JAR is a pUtform-independer 



Jm Cart Runtime esvtraamu (JCRE) consists of the Java Card Virtual Machine, the framework, «n<S the 
associated native methods. 

JC21R! Is an acronym, fbr the Java Card 2. 1 Reference Implementation. 

JCRE. fmplementer refers to a person creating a vendor-specific implementation using the Java Card AM. 

JCVM is an acronym for the Java Card Virtual Machine. The JCVM is the foundation of the OP card 
architecture. The JCVM execute; byte code and manages causes and objects. It enforces separation between 
applications (firewalls) and enables secure data sharing. 

JDK is an acronym fbr Java Development Kit The JDK is a Sub Microsystems, Inc. product that provides the 
environment required for programming in Java. The JDK is available fbr a variety of platforms, but most 
notably Sun Solaris and Microsoft Windows'". 

ame given fe> a proc^tet csr ruvtiac, associated with one or raere cU&es, is object -oriented 
Namespace tea set of names in which all names are unique. 

Object-Oriented is a programming methodology based 00 the concept of an object, which is a data structure 
encapsulated with a set of routines, called tntlhods, which operate en Ihe data. 



rs wpjqus taftucet of » dan rwtetwe denned aoccrding to the 
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Package u a namespace within the Java programming language and can have dimes and ioter&ees, A package 
it the smallest unit within the Java programming language. 

Persistent abject Persistent objects and their values persist from one CAD section to the next, indefinitely. 
Object* ate persistent by default. Ptrasteat object values are updated at omieally using transactions. The term 
persistent dees not mean there is an object-oriented database on the ixrd ar thai objects are 
lerufizcA'draJxulized just that the objects are not lost when the card lo$« power. 

Shareable interface Defines a set of shared interface methods. These interface methods can be invoked from 
one applet context when the object implementing them is owned by another applet context 

Shareable Interface object (SIO) An object that implements the stoeable intsrfsce. 

Transaetai ii as atomic operation in which She developer defines the extent of the operation by indicating in 
the program code the beginning and end of the transaction. 

Transient object The value* of transient objects do not persist from one CAD session to the next, and are reset 
to a default sate at specified intervals. Updates to the values of transient objects are not atomic and are not 
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1/5/99 12:49 PM Havnor: Stuffi JfCRE D2 14DEC98: READ-ME-JCRE21-DF2.txt Page 1 
Date: 16 December 1998 
Dear Java Card Licensee, 

JCRE2l-DF2-14DEC98j:ip contains a second draft of the Java Card 2.1 
Runtime Environment specification, dated December 14, 1998, for 
Licensee review and comment. We have worked incorporate and clarify 
the document based upon the review feedback we've received to date. 

Complete contents of the zip archive are as follows: 

READ-ME-JCRE2i-DF2.txt - This READ ME text file 

JCRE2 1 -DF2.pdf - "Java Card Runtime Environment (JCRE) 

2. 1 Specification" in PDF format 
JCRE2 1 -DF2-changebar.pdf > The revised document with change bars 

from previous version for ease of review. 

Summary of changes: 

1 . This is now a draft 2 release and will be published on the public web site shortly. 

2. New description of temporary JCRE Entry Point Objects has been introduced for purposes 
of restricting unauthorized access. 

Firewall chapter 6.2. 1. 

3. Global arrays now have added security related restrictions similar to temporary JCRE 
Entry Point objects. Firewall chapter 

622. 

4. Detailed descriptions of the bytecodes with respect to storing reswictions for temporary 
JCRE Entry Point Objects and 

Global arrays added. Chapter 6.2.8. 

5. General statement about JCRE owned exception objects added in chapter 8. 

6. Corrected description of Virtual machine resource failures in transient factory methods. 
Chapter 9.1. 

The "Java Card Runtime Environment 2.1 Specificatk>n" specifies the minimum behavior and runtime 
environment for complete Java Card 2.1 implementation, as referred to by the Java Card APT 2.1 and Java Card 
2.1 Virtual Machine Specification documents. This specification is required to ensure compatible operation of 
Java Card applets. The purpose of this specification document is to bring ail the JCRE elements together in a 
concise manner as part of the Java Card 2. 1 specification suite. 

Please send review comments to <javaoem-javacard@suacom> or to my address as below. On behalf of the 
Java Card team, I took forward to hearing from you. 

Best, 

Godfrey DiGiorgi 

Godfrey DiGiorgi - godfrey.digi0rgi@eng3un.com 

OEM Licensee Engineering 

Sun Microsystems / Java Software 

+ 1 408 343-1506 - FAX +1 408 517-5460 
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What is claimed is: 

1 . A small footprint device comprising: 

a. at least one processing element; 

b. memory, 

c. a context barrier using said memory for isolating program modules from one 
5 another; and 

d. a global data structure for permitting one program module to access 
information from another program module across said context barrier. 

2. The small footprint device of claim 1 in which said context barrier allocates 
separate name spaces for each program module. 

3. The small footprint device of claim 2 in which at least two program modules can 
access said global data structure even though they are located in different respective name 
spaces. 

4. The small footprint device of claim 1 in which said context barrier allocates 
separate memory spaces for each program module. 

5. The small footprint device of claim 4 in which at least two program modules can 
access said global data structure even though they are located in different respective 

memory spaces. 

6. The small footprint device of claim 1 in which said context barrier enforces 
security checks on at least one of a principal, an object and an action. 

7. The small footprint device of claim 6 in which at least one security check is 
based on partial name agreement between a principal and an object. 

8. The small footprint device of claim 7 in which at least one program can access 
said global data structure without said at least one security check. 

9. The small footprint device of claim 6 in which at least one security check is 
based on memory space agreement between a principal and an object. 
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10. The small footprint device of claim 9 in which at least one program can access 
a global data structure without said at least one security check. 

11. A method of operating a small footprint device, comprising the step of 
separating program modules using a context barrier and permitting access to information 
across the context barrier using a global data structure. 

12. The method of claim 1 i in which the context barrier will not permit a principal 
to perform an action on an object unless both principal and object are part of the same 
context unless the request is for access to a global data structure. 

13. A method of permitting access to information on a small footprint device from a 
first program module to a second program module separated by a context barrier, 
comprising the step of creating a global data structure which may be accessed by at least 
two program modules. 

14. A method of communicating across a context barrier separating program 
modules on a small footprint device, comprising the steps of: 

a. creating a global data structure; 

b. permitting at least one program module to write information to said global data 
structure; and 

c. having at least one other program module read information from said global data 
stnicture. 

15. A computer program product, comprising: 

a. a memory medium; and 

b. a computer controlling element comprising instructions for implementing a 

context barrier on a small footprint device and for bypassing said context barrier using a 
global data structure. 

16. The computer program product of claim 15 in which said medium is a carrier 



wave. 



17. A computer program product, comprising: 
a. a memory medium; and 
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b. a computer controlling element comprising instructions for separating a plurality 
of programs on a small footprint device by running them in respective contexts and for 
permitting one program to access information from another program by way of a global 
data structure. 

18. The computer program product of claim 17 in which said medium is a carrier 

wave. 

19. A carrier wave carrying instructions for implementing a global data structure 
for bypassing a context barrier on a small footprint device over a communications link. 

20. A carrier wave carrying instructions over a communications link for separating 
a plurality of programs on a small footprint device by running them in respective contexts 
and for permitting one program to access information from another program using at least 
one global data structure. 

21. A method of transmitting code over a network, comprising the step of 
transmitting a block of code from a server, said block of code comprising instructions for 
implementing a global data structure for bypassing a context barrier on a small footprint 
device over a communications link. 
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